getCatalogWorkRatings
列出一部作品的评分
分源评分。与 include=ratings 同一批条目。需要应用密钥。
get
/v2/catalog/works/{id}/ratings scope
catalog:readAuthorization: Bearer nmk_live_…（v2 应用密钥,门户自助铸造,无需申请）参数
| 参数 | 类型 | 位置 | 说明 |
|---|---|---|---|
id 必填 | string | path | 十进制 catalog 作品 id。 |
nsfw | string | query | true 包含 r18。false 或缺省则隐藏 r18。仅 true 或 false。 |
cursor | string | query | 来自先前 next_cursor 的不透明 keyset cursor。必须以 cur_ 开头。 |
limit | string | query | 页大小 1-100，缺省 20。 |
响应
facetsmap<string, object[]>具名 facet 桶。仅在请求 facets= 时出现。
«key»object[]可空
itemsobject[]必填本页成员。空数组，从不为 null。
distributionobject[]源原生刻度上的投票直方图，升序且稀疏：无票的取值没有桶。仅出现在作品详情面和 works/{id}/ratings，列表面永不携带。各柱不共用一个分母：bangumi、dlsite 和 howlongtobeat 把直方图与聚合一起发布，故其柱之和等于 vote_count；erogamescape 的柱来自独立同步的评论镜像，其和是自己的分母，不必等于 vote_count；vndb 的柱省略私有列表上的票，故其和至多为 vote_count。
rankintegerint64 必填 可空来源排名。未记录则为 null。
scorenumberdouble 必填来源原生的聚合分数。
sourcestring必填开放词表来源。不得用作判别条件。
statsobjectvote_countintegerint64 必填支撑 score 的票数。
missingstring[]已请求但不可见的 ids。仅出现在 ids=/refs= 批量车道。
next_cursorstring不透明 keyset cursor。末页省略。
objectstring必填类型判别字段。恒为 list。
枚举listtotalintegerint64仅当 include_total=true 时出现。与 items 同一可见性闸。
请求示例
cURL
curl "https://api.nextmoe.dev/v2/catalog/works/value/ratings" \
-H "Authorization: Bearer nmk_live_<YOUR_KEY>"