getCatalogRelease
获取一个发行
一条 catalog 发行。合并后的 id 返回 404 ENTITY_MERGED。r18 父作品在未带 nsfw=true 时返回 404。可匿名调用,按 IP 地址限流;应用密钥或带 catalog:read 的用户访问令牌各有更高的额度。
get
/v2/catalog/releases/{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 始终保留。 |
响应
datestringdate 必填 可空日历日期。无日期则为 null。
engineobjectdisplay_namestring必填不得用作判别条件。
idstring必填catalog 引擎 id。
objectstring必填类型判别字段。恒为 engine。
枚举engine
idstring必填catalog 发行 id。
langstringbcp47 必填BCP-47。未记录则为空。
objectstring必填类型判别字段。恒为 release。
枚举releaseplatformstring必填不得用作判别条件。
platformsstring[]必填本发行上的全部平台。空数组,从不为 null。
refsobject[]必填exact 上游锚。空数组,从不为 null。
external_idstring必填上游 id 原文。除精确匹配外不得用作判别条件。它是该实体自身粒度上的身份锚,不一定对应可访问页面:credit-name 的 vndb ref 是没有独立页面的 staff-alias id。可浏览 URL 来自 links。
sourcestring必填开放词表来源。不得用作判别条件。
release_kindstring必填发售类别。
枚举defaultdigitalphysicaltrialpatchtitlestring必填 可空不得用作判别条件。
work_idstring必填 可空父作品 id。在作品子资源上为 null,此时作品由 URL 给出。
请求示例
cURL
curl "https://api.nextmoe.dev/v2/catalog/releases/1"