文档 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 而非丢弃它。持有 catalog.edit.trusted 的调用方直接铸造为 live 而非 pending。需要绑定到 catalog 站点的用户访问令牌。

post/v2/me/claims

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

请求体

application/json

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。不得用作判别条件。
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 '{}'