# POST /v1/disputes

创建申诉

创建申诉，消息最多5,000个Unicode字符。每位站长最多同时有五个未解决的申诉，每个广告位在24小时内最多一个广告位质量申诉。申诉对象必须属于该站长。需要`publisher:write`；代查看模式为只读。速率限制等级：`write`。

- 所需权限范围: `publisher:write`
- 速率限制: `write` — 20 次请求/60秒窗口 每个API密钥或网页会话

## 参数

无参数。

## 请求体

```
{ message: string; subject_id?: integer | null; subject_type: "hold" | "adjustment" | "ivt" | "zone_quality" | "payout" | "other" }
```

## 响应

```
{ amount_returned: string | null; first_response_at: string | null; first_response_due_at: string; id: integer; messages: { author_type: "publisher" | "admin"; body: string; created_at: string; id: integer }[]; opened_at: string; overdue: boolean; resolution: "upheld" | "rejected" | "partial" | null; resolve_due_at: string; resolved_at: string | null; status: "open" | "answered" | "resolved"; subject_id: integer | null; subject_type: "hold" | "adjustment" | "ivt" | "zone_quality" | "payout" | "other" }
```

## 错误

有速率限制的路由会返回`RateLimit-Limit`、`RateLimit-Remaining`和`RateLimit-Reset`（距窗口结束的秒数）；429响应还会带有`Retry-After`。限流器暂时不可用时，这些响应头可能缺失（此时请求会被放行）。

| 状态码 | 含义 |
|---|---|
| 401 | API密钥缺失、无效或已被撤销。 |
| 403 | 该密钥缺少所需的权限范围，或该主体无权执行此操作。 |
| 429 | 已超出速率限制；请等待`Retry-After`秒后重试。 |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |

HTML文档: https://agimone.com/zh/developers/api/#create-dispute
API 2026-10
