# DELETE /v1/zones/{id}

حذف منطقة

يحذف منطقة. يتطلب صلاحية manage في حسابك (اطلب من الدعم تفعيلها)؛ وإلا فيُرجع 403 مع reason بقيمة manage_not_allowed. عند استخدام مفتاح API أرسل الترويسة X-Adnet-Confirm: true. تتوقف الزيارات خلال ثوانٍ؛ وتُحفظ الإحصاءات والأرباح. تواصل مع الدعم لاستعادة المنطقة. تتطلب الصلاحية `publisher:write` (مفتاح API أو جلسة ويب)؛ وغير متاحة في العرض بصفة مستخدم آخر. فئة حد المعدل: `write`.

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

## المعاملات

| الاسم | الموضع | النوع | مطلوب |
|---|---|---|---|
| `id` | path | integer | نعم |
| `x-adnet-confirm` | header | string | لا |

## الاستجابة

```
any
```

## الأخطاء

تعيد المسارات الخاضعة لحد المعدل الترويسات `RateLimit-Limit` و`RateLimit-Remaining` و`RateLimit-Reset` (عدد الثواني حتى انتهاء النافذة)؛ وتحمل الاستجابة 429 أيضًا `Retry-After`. قد تغيب الترويسات أثناء عدم توفر المحدّد مؤقتًا (وتمرّر الطلبات حينئذ).

| الحالة | المعنى |
|---|---|
| 401 | مفتاح API مفقود أو غير صالح أو ملغى. |
| 403 | ينقص المفتاح الصلاحية المطلوبة، أو العملية غير مسموح بها لهذا الطرف. |
| 429 | تم تجاوز حد المعدل؛ انتظر `Retry-After` ثانية. |
| 404 | Default Response |
| 428 | Default Response |

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