# POST /v1/sites

创建网站

注册新网站时返回 201。若有 `manage` 权限，重新添加自己已删除网站的域名会恢复原网站，保留原 ID 和状态，并应用请求中的分类（返回 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/zh/developers/api/#create-site
API 2026-10
