# POST /v1/sites

Tạo trang web

Đăng ký trang web mới (201). Nếu có quyền `manage`, thêm lại tên miền của trang web bạn đã xoá sẽ khôi phục trang web với cùng mã định danh, giữ nguyên trạng thái và áp dụng thể loại đã chọn (200). Khi trả 409, `reason` là `domain_exists` nếu tên miền đã thuộc trang web chưa bị xoá của bạn, `domain_taken` nếu nhà xuất bản khác đang giữ tên miền, hoặc `domain_archived` nếu bạn thiếu quyền khôi phục trang web đã xoá của mình. 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`.

- 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ố

Không có tham số.

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

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

## Phản hồi

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

## 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 |
| 409 | Default Response |

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