文档 API v2getCatalogSeries

getCatalogSeries

获取一个系列

系列详情。has_nsfw 报告是否有成员作品落在 r18 展示闸之后。include=intros,refs 追加对应块。可匿名调用，按 IP 地址限流；应用密钥或带 catalog:read 的用户访问令牌各有更高的额度。

get/v2/catalog/series/{id}

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。
`view`	`string`	`query`	basic（默认）或 full。封闭词表。
`include`	`string`	`query`	逗号分隔的块。未知 token 返回 400 UNKNOWN_INCLUDE。
`fields`	`string`	`query`	逗号分隔的顶层键。未知 token 返回 400 UNKNOWN_FIELD。object 与 id 始终保留。

响应

display_namestring 必填
不得用作判别条件。
has_nsfwboolean 必填
GET /v2/catalog/works?series_id={id}&nsfw=true 列出的作品中，是否有落在 r18 展示闸之后的（content_limit=nsfw）。不受本次调用的 nsfw= 收窄，因此一个系列可以报告 true，而 work_count 把这类成员全部藏掉。每条车道都携带。
idstring 必填
catalog 系列 id。
introsobject[]
系列简介，每种语言一条。仅当 include=intros 时出现，且仅在详情面。没有则为空数组。此处 is_machine 恒为 false：存储层不携带系列简介的出处，因此 false 记录的是未知，而不是人工撰写。
- is_machineboolean 必填
  该简介是否机翻。
- langstringbcp47 必填
  BCP-47 语言标签。
- sourcestring 必填
  开放词表来源。不得用作判别条件。
- valuestring 必填
  不得用作判别条件。
objectstring 必填
类型判别字段。恒为 series。
枚举series
refsobject[]
此系列的 exact 上游锚。在 include=refs 时出现，仅详情面。没有则为空数组。
- external_idstring 必填
  上游 id 原文。除精确匹配外不得用作判别条件。它是该实体自身粒度上的身份锚，不一定对应可访问页面：credit-name 的 vndb ref 是没有独立页面的 staff-alias id。可浏览 URL 来自 links。
- sourcestring 必填
  开放词表来源。不得用作判别条件。
work_countintegerint64 必填
在同一 nsfw 下、不加其他筛选时，GET /v2/catalog/works?series_id={id} 列出的作品数。

请求示例

cURL

curl "https://api.nextmoe.dev/v2/catalog/series/1"