访问与请求

无需密钥、只读、在服务器端调用；ID、日期和缺失值的格式。

无需密钥，无需注册

公开 API 不需要 API 密钥、令牌或账号。本文档中的每个操作都是匿名的 GET 请求：发送请求，读取 JSON 即可。

Shell

curl "https://api.nogitsu.com/v1/works?limit=3"

API 只发布任何人在 nogitsu.com 上已经能看到的内容。账号、作品库、个人主页的非公开栏目、管理功能以及所有写入操作都不属于公开 API，本文档也不作介绍。

其他网站的网页无法在浏览器中调用此 API：仅允许来自 nogitsu.com 的跨域请求。请从你的服务器、脚本或构建步骤发送请求，并保存一份响应副本。

请发送注明应用名称的 User-Agent 请求头，例如 my-app/1.0。我们的网络防护会以非 JSON 的 403 页面拦截部分库的默认代理，例如 Python urllib 发送的代理。

Shell

curl -A "my-app/1.0 (+https://example.com)" "https://api.nogitsu.com/v1/genres"

响应为 UTF-8 编码的 JSON。ID 为 UUID。日期写作 YYYY-MM-DD，时间点写作 UTC 的 ISO 8601 时间戳。未知的值为 null，绝不会用 0 或空文本代替。

JSON

{
  "id": "01a0cac5-388a-75ed-a3a6-4a5d2db4261e",
  "startDate": "2018-03-04",
  "season": null,
  "seasonYear": null
}