文档 API v2batchMyWorkStates

batchMyWorkStates

批量写入作品状态

207 多状态。每项为 work_state 或 problem。需要用户访问令牌。任何应用均可调用；不要求任何 scope。

post/v2/me/work-states

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

参数

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

请求体

application/json

itemsobject[] 必填
最多 100 项。
- completionstring
  通了多少。缺省即清除。与 wish 同用会被拒绝。
  枚举one_routemainall
- statestring 必填
  封闭词表。
  枚举wishdoingdoneon_holddropped
- work_idstring 必填
  作品 id。

响应

请求示例

cURL

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