# POST /v1/disputes

Mở khiếu nại

Mở khiếu nại IVT, chất lượng vùng quảng cáo, khoản giữ, điều chỉnh, yêu cầu rút hoặc nội dung khác, với tin nhắn tối đa 5.000 ký tự Unicode. Tối đa 5 khiếu nại chưa kết luận; mỗi vùng quảng cáo có tối đa một khiếu nại chất lượng trong 24 giờ. Đối tượng phải thuộc nhà xuất bản. Cần quyền `publisher:write`; không ghi trong chế độ xem thay. Tầng giới hạn tốc độ: `write`.

- Quyền cần có: `publisher:write`
- Giới hạn tốc độ: `write` — 20 yêu cầu mỗi cửa sổ 60 giây cho mỗi API key hoặc phiên web

## Tham số

Không có tham số.

## Nội dung yêu cầu

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

## Phản hồi

```
{ 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" }
```

## Lỗi

Các route có giới hạn tốc độ trả `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (số giây tới hết cửa sổ); phản hồi 429 có thêm `Retry-After`. Header có thể vắng khi bộ giới hạn tạm thời không sẵn sàng (khi đó yêu cầu vẫn được cho qua).

| Mã | Ý nghĩa |
|---|---|
| 401 | Thiếu, sai hoặc đã thu hồi API key. |
| 403 | Key thiếu quyền cần có, hoặc thao tác không được phép với tác nhân này. |
| 429 | Vượt giới hạn tốc độ; chờ `Retry-After` giây. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |

Tài liệu HTML: https://agimone.com/vi/developers/api/#create-dispute
API 2026-10
