# GET /v1/zones/{id}/code

عرض شيفرة تضمين المنطقة

تعيد مقتطف شيفرة التضمين لمنطقة إعلانية. تتطلب الصلاحية `publisher:read` (مفتاح API أو جلسة ويب). فئة حد المعدل: `read`.

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

## المعاملات

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

## الاستجابة

```
{ direct_url: string | null; loader: string; tag: { adblock_rate: number | null; last_load_at: string | null; last_request_at: string | null; loads_24h: integer; requests_24h: integer; state: "never" | "stale" | "live"; via: "tag" | "smart_link" | "both" | null } }
```

## الأخطاء

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

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

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