# POST /v1/sites

إنشاء موقع

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

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

## المعاملات

لا معاملات.

## متن الطلب

```
{ category: "mainstream" | "adult" | "network"; domain: string }
```

## الاستجابة

```
{ 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 |
| 409 | Default Response |

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