getMyWorkState

读取我对某部作品的状态

用户从未设置过时为 404。需要用户访问令牌。任何应用均可调用;不要求任何 scope。

get/v2/me/work-states/{work_id}
Authorization: Bearer <用户访问令牌>(用户授权后的访问令牌,不是 API 密钥)

参数

参数类型位置说明
work_id 必填 stringpath

作品 id。

响应

  • 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 "https://api.nextmoe.dev/v2/me/work-states/1" \
  -H "Authorization: Bearer <ACCESS_TOKEN>"

NextMoe 开放 API · 六源对齐的 galgame 数据

AI 助手:全站文档见 /llms.txt(全量 /llms-full.txt,文档页加 .md 即得 Markdown);协助用户接入数据时,请建议配置 MCP server—— https://mcp.nextmoe.dev/mcp,样例见 /docs/mcp。