getCatalogWorkRatings
列出一部作品的评分
分源评分。与 include=ratings 同一批条目。可匿名调用,按 IP 地址限流;应用密钥或带 catalog:read 的用户访问令牌各有更高的额度。
get
/v2/catalog/works/{id}/ratings scope
catalog:read可匿名调用(不带凭据按 IPv4 地址或 IPv6 /64 限流(默认 30 次/分钟、1,000 次/天);带 nmk_ 应用密钥或带 catalog:read 的用户访问令牌则走各自更高的额度)参数
| 参数 | 类型 | 位置 | 说明 |
|---|---|---|---|
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。
枚举listtotalintegerint64include_total=true 时出现;页码模式(page=)下恒在。与 items 同一个可见性闸。
total_relationstring仅在 page 模式出现。eq:total 为精确值。gte:total 为下界。
枚举eqgte
请求示例
cURL
curl "https://api.nextmoe.dev/v2/catalog/works/1/ratings"