文档 API v2createMyClaim

createMyClaim

提交认领

铸造或认领一部作品。work_id 认领已有作品。refs= 认领它们解析到的作品；无一匹配时按 display_name 铸造一部。site_work_id 配 display_name、且既无 work_id 也无 refs 时，铸造一部锚定到站点自身 id 的作品。field_values 把编辑引擎的作品字段映射带到任意铸造车道，也可单独发送、不带 work_id、refs 或 site_work_id；与 work_id 同发会被拒绝；refs 已解析到作品时返回 409 而非丢弃它。released 走同样的铸造车道、受同样的两道拒绝，成为铸出作品上的一条 curated catalog_release 行。持有 catalog.claim.trusted 的调用方直接铸造为 live 而非 pending。若铸造的 display_name 或 catalog.work.titles 与同一 medium 的在用作品同名，则返回 409 DUPLICATE_SUSPECTS，在 suspects[] 中列出它们，且一行不写；带 confirm_duplicates=true 重发即照旧铸造。认领车道——work_id、以及能解析的 refs——永不走这道闸。在滑动窗口内用满 catalog.claim_writes_per_day 的贡献者会被拒以 429 QUOTA_EXCEEDED；持 catalog.claim.trusted 者按更高的 catalog.claim_writes_per_day_trusted 计。需要绑定到 catalog 站点的用户访问令牌。令牌须带 catalog:edit scope。

post/v2/me/claims

Authorization: Bearer <用户访问令牌>（用户授权后的访问令牌,不是 API 密钥）

参数

参数	类型	位置	说明
`Idempotency-Key`	`string`	`header`	让请求可以安全重试。24 小时内同一把键配同一请求体，会带着 Idempotency-Replayed: true 重放第一次的响应；同一把键配不同请求体是 409 IDEMPOTENCY_KEY_REUSED；第一次请求还在处理时重试是 409 IDEMPOTENCY_REQUEST_IN_PROGRESS。范围限定为调用方与路径。

请求体

application/json

confirm_duplicatesboolean
即使同一 medium 的在用作品与提交的标题同名也照铸。不带它时，这类铸造会以 409 DUPLICATE_SUSPECTS 被拒，作品列在 suspects[] 中，且一行不写。确认后仍会把这些对子记入对账队列。只有铸造车道读取本字段。
display_namestring
当 refs 未能匹配时，铸造新行所必需。不得用作判别条件。
field_valuesmap<string, object>
铸造作品时的编辑引擎字段键到值，例如 catalog.work.titles——与 GET /v2/moderation/snapshots/{object}/{id} 的形状相同。单独发送则从该 map 铸造；与 work_id 同发为 422。顶层 display_name 优先于 catalog.work.display_name。
- «key»object
refsobject[]
source:external_id 锚，最多 100 个。在 work_id 缺席时使用。
- external_idstring 必填
  上游 id 原文。除精确匹配外不得用作判别条件。
- sourcestring 必填
  开放词表来源键，如 vndb。不得用作判别条件。
releasedobject
- dintegerint32
  发售日；0 或缺省表示未知。需要同时给 m。
- mintegerint32
  发售月份；0 或缺省表示未知。
- yintegerint32 必填
  发售年份。
site_work_idstring
站点自己的作品 id。单独与 display_name 一起发送——不要 work_id，不要 refs——会铸造一部锚定到该 id 的作品。
work_idstring
要认领的既有 catalog 作品 id。

响应

请求示例

cURL

curl -X POST "https://api.nextmoe.dev/v2/me/claims" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"work_id":"1"}'