# 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/ar/developers/api/#create-dispute
API 2026-10
