公开 API

发布番剧资源

番剧发布必须指定 animeIdType 与 animeId,不按标题匹配番剧。 Idempotency-Key 从首次受理起绑定完整请求。同键改参返回 409 CONFLICT;缺少绑定的旧未完成上传请求返回 legacy_request_binding_missing,两者均须使用新键。重放及 503 重试规则见「接口约定与鉴权」。

POST
/api/releases/publish

授权

授权Bearer <token>

字幕组 API Key。Authorization: Bearer <KEY>。与 X-API-Key 二选一,Bearer 优先。 Key scope:releases:publish、releases:delete、releases:sync:read,至少选一个。

位置: header

标头参数

Idempotency-Key?string

同一 API Key 和端点的同一普通发布请求重试复用此值。已提交或已删除的旧命令返回原回执;删除后重新发布使用新值。不提供、空值或超过 256 字符时按新命令处理。跨站浏览器预检目前不允许此头。

长度1 <= length <= 256

请求主体

TypeScript 定义

在 TypeScript 中使用 request body 类型。

响应主体

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/releases/publish" \  -H "Content-Type: application/json" \  -d '{    "animeIdType": "bgm",    "animeId": "string",    "title": "string",    "magnetBase64": "string",    "torrentStorageId": "string"  }'

{  "ok": true,  "result": {    "releaseId": "rel_example",    "revision": 1,    "torrentObjectId": "obj_example"  }}