# POST /v1/sites/{id}/restore

استعادة موقع

استعِد موقعًا محذوفًا تملكه والمناطق الإعلانية المحذوفة معه. تبقى المناطق المستعادة متوقفة مؤقتًا. يُعاد الموقع غير المحذوف ببياناته الحالية. تتطلب العملية صلاحية `manage`. إذا كان النطاق قيد الاستخدام، تعيد العملية 409 بقيمة `domain_taken` في `reason`. تتطلب الصلاحية `publisher:write` (مفتاح API أو جلسة ويب)؛ وغير متاحة في العرض بصفة مستخدم آخر. فئة حد المعدل: `write`.

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

## المعاملات

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

## الاستجابة

```
{ 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` ثانية. |
| 404 | Default Response |
| 409 | Default Response |

وثائق HTML: https://agimone.com/ar/developers/api/#restore-site
API 2026-10
