文档 API v2putMyWorkState

putMyWorkState

替换我对某部作品的状态

请求体携带 state，可选 completion；缺省的 completion 即清除。天然幂等。需要用户访问令牌。任何应用均可调用；不要求任何 scope。

put/v2/me/work-states/{work_id}

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

参数

参数	类型	位置	说明
`work_id` 必填	`string`	`path`	作品 id。

请求体

application/json

completionstring
通了多少。缺省即清除。与 wish 同用会被拒绝。
枚举one_routemainall
statestring 必填
封闭词表。
枚举wishdoingdoneon_holddropped

响应

completionstring 必填可空
通了多少：一条线、主线、或全线。未声明时为 null。绝不与 wish 同时出现。
枚举one_routemainall
created_atstringdate-time 必填
RFC 3339 UTC。
objectstring 必填
类型判别符。恒为 work_state。
枚举work_state
statestring 必填
封闭词表。wish 想玩、doing 在玩、done 至少通完一条线、on_hold 搁置、dropped 抛弃。与 Bangumi 收藏类型一一对应。
枚举wishdoingdoneon_holddropped
updated_atstringdate-time 必填
RFC 3339 UTC。增量同步的水位线。
work_idstring 必填
该状态所在的作品 id。

请求示例

cURL

curl -X PUT "https://api.nextmoe.dev/v2/me/work-states/1" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"completion":"all","state":"done"}'