# PUT /v1/zones/{id}

Cập nhật vùng quảng cáo

Cập nhật các trường của một vùng quảng cáo thuộc nhà xuất bản. Cần quyền `publisher:write` (khoá API hoặc phiên web); không dùng được trong chế độ xem thay. Tầng giới hạn tốc độ: `write`. Đổi tên và đổi tần suất không cần xác nhận. Với khoá API, tạm dừng vùng đang chạy hoặc tắt Smart Link của vùng cần header `X-Adnet-Confirm: true` (nếu không, trả 428). Đổi `direct_url_enabled` cần quyền Direct Link (403 `direct_link_not_allowed`). Sau khi trang web được duyệt, vùng quảng cáo thuộc trang web loại `network` có thể đổi từ `mainstream` sang `adult`. Đổi từ `adult` sang `mainstream` cần quyền `manage` (409 `manage_not_allowed` nếu thiếu quyền).

- Quyền cần có: `publisher:write`
- Giới hạn tốc độ: `write` — 20 yêu cầu mỗi cửa sổ 60 giây cho mỗi API key hoặc phiên web

## Tham số

| Tên | Vị trí | Kiểu | Bắt buộc |
|---|---|---|---|
| `id` | path | integer | có |
| `x-adnet-confirm` | header | string | không |

## Nội dung yêu cầu

```
{ 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; status?: "active" | "paused" }
```

## Phản hồi

```
{ 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 }
```

## Lỗi

Các route có giới hạn tốc độ trả `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (số giây tới hết cửa sổ); phản hồi 429 có thêm `Retry-After`. Header có thể vắng khi bộ giới hạn tạm thời không sẵn sàng (khi đó yêu cầu vẫn được cho qua).

| Mã | Ý nghĩa |
|---|---|
| 401 | Thiếu, sai hoặc đã thu hồi API key. |
| 403 | Key thiếu quyền cần có, hoặc thao tác không được phép với tác nhân này. |
| 429 | Vượt giới hạn tốc độ; chờ `Retry-After` giây. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |
| 428 | Default Response |

Tài liệu HTML: https://agimone.com/vi/developers/api/#update-zone
API 2026-10
