# PUT /v1/sites/{id}

تحديث موقع

غيّر فئة موقعك إلى `mainstream` أو `adult` أو `network`. يُفضّل استخدام `PATCH /v1/sites/{id}`. تعيد العملية 200 عند اكتمال التحديث. تستلزم بعض تغييرات الفئة لموقع معتمد مراجعةً. تعيد الاستجابة 202 الفئة المطلوبة في `pending_category`، ويستمر الموقع في استخدام فئته الحالية `category` حتى انتهاء المراجعة. أرسل الفئة الحالية لإلغاء الطلب المعلّق. تتطلب الصلاحية `publisher:write` (مفتاح API أو جلسة ويب)؛ وغير متاحة في العرض بصفة مستخدم آخر. فئة حد المعدل: `write`.

- الصلاحية المطلوبة: `publisher:write`
- حد المعدل: `write` — 20 طلبًا لكل نافذة مدتها 60 ثانية لكل مفتاح API أو جلسة ويب

## المعاملات

| الاسم | الموضع | النوع | مطلوب |
|---|---|---|---|
| `id` | path | integer | نعم |

## متن الطلب

```
{ category: "mainstream" | "adult" | "network" }
```

## الاستجابة

```
{ category: "mainstream" | "adult" | "network"; created_at: string; deleted_at: string | null; domain: string; id: integer; notes: string | null; pending_category: "mainstream" | "adult" | "network" | null; pending_category_at: string | null; publisher_note: string | null; status: "pending" | "approved" | "rejected"; zones_count: integer }
```

## الأخطاء

تعيد المسارات الخاضعة لحد المعدل الترويسات `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/#update-site
API 2026-10
