- 默认模块
- ZHIYU-WAF V2 Control Plane API
- Public
- Authentication
- Dashboard
- Security Events
- Attack Logs
- Audit
- Rules
- Access Control
- Threat Intelligence
- Sites
- AI
- SSH Monitoring
- Settings
- Backup
- Certificates
- Users
- 数据模型
- ApiError
- V2Envelope
- V2ErrorEnvelope
- HealthResponse
- LoginRequest
- TokenResponse
- ChangePasswordRequest
- StatusResponseBody
- SetupApplyRequest
- V2SystemStatus
- V2Site
- V2SiteInput
- SecurityEvent
- SecurityEventPage
- CreateBlockedIPRequest
- BlockedIP
- AttackLog
- AttackLogPage
- AuditEvent
- AuditEventPage
- Rule
- RuleInput
- IPEntry
- IPEntryInput
- GeoRule
- GeoRuleInput
- AIConfiguration
- AIGlobalUpdate
- AITestResponse
- Settings
- BackupData
- Certificate
- User
- CreateUserRequest
手动封禁 IP
POST
/api/v1/blocked-ips
ttl 使用 Go Duration，例如 1h30m。留空表示永久封禁。请求参数
Authorization
JWT Bearer
在 Header 添加参数
Authorization
示例：
Authorization: ********************or
Body 参数application/json必填
示例
{
"ip": "198.51.100.42",
"ttl": "24h",
"reason": "manual containment after incident triage"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/v1/blocked-ips' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"ip": "198.51.100.42",
"ttl": "24h",
"reason": "manual containment after incident triage"
}'返回响应
🟢201
application/json
Bodyapplication/json
示例
{
"data": {
"id": 0,
"ip": "string",
"family": 4,
"reason": "string",
"score": 0,
"expires_at": "2019-08-24T14:15:22.123Z",
"permanent": true,
"source": "manual",
"created_at": "2019-08-24T14:15:22.123Z"
},
"request_id": "req_37b75078-6cbf-48f6-b8f3-3ec81d6fb2e5"
}🟠400V2BadRequest
🔴503V2ServiceUnavailable
修改于 2026-08-18 04:50:02