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

Buat zona

Buat zona iklan di bawah sebuah situs. Memerlukan scope `publisher:write` (kunci API atau sesi web); tidak tersedia di view-as. Tingkat batas laju: `write`.

- Scope wajib: `publisher:write`
- Batas laju: `write` — 20 permintaan per jendela 60 detik per kunci API atau sesi web

## Parameter

| Nama | Di | Tipe | Wajib |
|---|---|---|---|
| `id` | path | integer | ya |

## Isi permintaan

```
{ category?: "mainstream" | "adult"; direct_url_enabled?: boolean; freq?: { cap_count?: integer; cap_window_s?: integer; delay_s?: integer; min_interval_s?: integer; per_page?: integer | null; preset: "light" | "balanced" | "strong" | "per_page" | "custom"; repeat_after_s?: 0 | integer }; freq_cap_count?: integer; freq_cap_hours?: integer; name: string }
```

## Respons

```
{ adblock_rate: number | null; category: "mainstream" | "adult"; category_source: "site" | "zone"; created_at: string; direct_url_enabled: boolean; freq: { cap_count: integer; cap_window_s: integer; delay_s: integer; min_interval_s: integer; per_page: integer | null; preset: "light" | "balanced" | "strong" | "per_page" | "custom"; repeat_after_s?: 0 | integer }; freq_cap_count: integer; freq_cap_hours: integer; id: integer; last_load_at: string | null; last_request_at: string | null; loads_24h: integer; name: string; requests_24h: integer; site_domain: string; site_id: integer; status: "active" | "paused"; tag_state: "never" | "stale" | "live"; via: "tag" | "smart_link" | "both" | null }
```

## Error

Rute yang dibatasi lajunya mengembalikan `RateLimit-Limit`, `RateLimit-Remaining`, dan `RateLimit-Reset` (detik hingga jendela berakhir); respons 429 juga menyertakan `Retry-After`. Header ini bisa tidak ada saat pembatas laju sementara tidak tersedia (permintaan lalu diteruskan).

| Status | Arti |
|---|---|
| 401 | Kunci API tidak ada, tidak valid, atau sudah dicabut. |
| 403 | Kunci tidak memiliki scope yang diperlukan, atau operasi tidak diizinkan untuk aktor ini. |
| 429 | Batas laju terlampaui; tunggu `Retry-After` detik. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |

Dokumentasi HTML: https://agimone.com/id/developers/api/#create-zone
API 2026-10
