getMyRating

读取我对某部作品的评分

用户未给这部作品评分时为 404。需要用户访问令牌。任何应用均可调用;不要求任何 scope。

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

参数

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

作品 id。

响应

  • aspect_scoresobject 必填
    • artintegerint64 必填 可空

      未评分时为 null。

    • characterintegerint64 必填 可空

      未评分时为 null。

    • musicintegerint64 必填 可空

      未评分时为 null。

    • replay_valueintegerint64 必填 可空

      未评分时为 null。

    • routeintegerint64 必填 可空

      未评分时为 null。

    • storyintegerint64 必填 可空

      未评分时为 null。

    • systemintegerint64 必填 可空

      未评分时为 null。

    • voiceintegerint64 必填 可空

      未评分时为 null。

  • client_idstring 必填

    首次写入这条评分的应用的 OAuth client;之后从别的应用编辑不会改变它。站点可以拿它和自己的 client id 比较,区分经本站写入的评分和只是镜像来的评分;除此之外不得用作判别依据。

  • created_atstringdate-time 必填

    RFC 3339 UTC。

  • idstring 必填

    评分 id。编辑与作品合并都不会改变它,删除后的 id 也永不复用,所以保留评分副本的站点以它为键。

  • objectstring 必填

    类型判别符。恒为 rating。

    枚举rating
  • overallintegerint64 必填

    总分,1 到 10 的整数。

  • recommendstring 必填

    作者对这部作品的推荐程度。

    枚举strong_nononeutralyesstrong_yes
  • short_summarystring 必填

    作者的短评,纯文本。没有时为空字符串。不得用作判别依据。

  • sitestring 必填

    该应用绑定的目录站点,未绑定时为空。开放词表;仅供展示,不得用作判别依据。

  • spoiler_levelstring 必填

    作者声明的 short_summary 剧透程度。隐藏剧透的读者看到的,凡高于 none 的短评都会被遮住。

    枚举noneportionserious
  • updated_atstringdate-time 必填

    RFC 3339 UTC。作者最近一次编辑这条评分的时间;从站点导入的评分保留站点上的时间。

  • user_idstring 必填

    作者。这是所有 NextMoe 站点共用的中央登录用户 id,不是某个站点自己的用户 id。

  • work_idstring 必填

    这条评分所属的作品 id。

  • work_stateobject 必填 可空

    作者在这部作品上当前的游玩状态,不是写评分时的状态。作者没有设置时为 null。它变化时,这条评分会出现在 /v2/ratings/changes。

    • completionstring 必填 可空

      通了多少。未说明时为 null。

      枚举one_routemainall
    • statestring 必填

      封闭词表,与 /v2/me/work-states 相同。

      枚举wishdoingdoneon_holddropped

请求示例

cURL
curl "https://api.nextmoe.dev/v2/me/ratings/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。