文档 API v2putMyRating

putMyRating

给作品评分，或替换我对它的评分

创建评分，或替换它的全部字段；id、client_id 与 site 保持首次写入时的值。原样重发不会写入任何东西。作品在 /v2/catalog/works/{id}/ratings 上的 nextmoe 分数随即更新。任何应用都可以写评分；评分在所有站点公开。第一方站点在发送前自己检查 short_summary。第三方应用的令牌写入新的或改动过的 short_summary 时，由中央做内容检查：被拒绝时返回 422 VALIDATION_FAILED，指向 /short_summary，reason 为 NOT_ALLOWED_VALUE，不写入任何东西。需要用户访问令牌；不要求任何 scope。

put/v2/me/ratings/{work_id}

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

参数

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

请求体

application/json

aspect_scoresobject
- artintegerint64
  未评分时缺省或为 null。
- characterintegerint64
  未评分时缺省或为 null。
- musicintegerint64
  未评分时缺省或为 null。
- replay_valueintegerint64
  未评分时缺省或为 null。
- routeintegerint64
  未评分时缺省或为 null。
- storyintegerint64
  未评分时缺省或为 null。
- systemintegerint64
  未评分时缺省或为 null。
- voiceintegerint64
  未评分时缺省或为 null。
overallintegerint64 必填
总分，1 到 10 的整数。
recommendstring 必填
作者对这部作品的推荐程度。
枚举strong_nononeutralyesstrong_yes
short_summarystring
短评，纯文本。缺省或为空表示没有。自由文本；不得用作判别依据。
spoiler_levelstring
short_summary 的剧透程度。缺省即 none。
枚举noneportionserious

响应

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 -X PUT "https://api.nextmoe.dev/v2/me/ratings/1" \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"aspect_scores":{"art":8,"character":8,"music":9,"replay_value":8,"route":7,"story":8,"system":7,"voice":8},"overall":8,"recommend":"yes","short_summary":"画面和音乐都很出色，主线一周目通关后还想再走一遍。","spoiler_level":"none"}'