# POST /v1/disputes/{id}/messages

Gửi tin nhắn khiếu nại

Gửi thêm tin nhắn tối đa 5.000 ký tự Unicode vào khiếu nại của nhà xuất bản chưa kết luận. Khiếu nại đã được trả lời chuyển lại thành đang mở khi nhà xuất bản viết tiếp. 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ố

| Tên | Vị trí | Kiểu | Bắt buộc |
|---|---|---|---|
| `id` | path | integer | có |

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

```
{ message: string }
```

## 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-message
API 2026-10
