文档 API v2getCatalogCharacter

getCatalogCharacter

获取一个角色

角色详情。view=full 会加入 gender、birthday、measurements、blood_type、instance_of_id。include=image,figure,traits,aliases,intros,refs 会加入立绘、特征、名称、描述与锚点块。spoiler=none|minor|major 是 traits 块的上限，默认为 none。合并后的 id 返回 404 ENTITY_MERGED。需要应用密钥。

get/v2/catalog/characters/{id}

scope catalog:readAuthorization: Bearer nmk_live_…（v2 应用密钥,门户自助铸造,无需申请）

参数

参数	类型	位置	说明
`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 始终保留。
`spoiler`	`string`	`query`	特征块的剧透上限：none（缺省）、minor 或 major。封闭词表；未知值为 400。超过上限的特征行不下发。只有源自 VNDB 的特征词表带剧透等级，缺省为安全上限。

响应

aliasesobject[]
本角色名的别名拼写。在 include=aliases 时出现，仅详情面。没有则为空数组。
- alias_kindstring 必填
  search_hint 为内部取值，永不出现在本类型上。
  枚举translationspelling_variant
- is_machineboolean 必填
  该名称是否机翻。
- langstringbcp47 必填
  BCP-47 语言标签。
- valuestring 必填
  不得用作判别条件。
birthdaystring
MM-DD。在 view=full 时出现。未记录则为 null。不是日期：没有年份。
blood_typestring
在 view=full 时出现。未记录则为 null。
枚举ababo
display_namestring 必填
不得用作判别条件。
figureobject
- hashstring 必填
  图床内容哈希。
- heightintegerint64 必填可空
  像素高度。未知则为 null。
- sexualstring 必填可空
  性描写。null 表示未评估。
  枚举safesuggestiveexplicit
- sourcestring 必填
  开放词表来源。不得用作判别条件。
- thumbhashstring 必填可空
  Thumbhash。未知则为 null。
- urlstringuri 必填
  图片的绝对 URL。从不为裸 hash。
- violencestring 必填可空
  暴力描写。null 表示未评估。目前没有任何 catalog 行经过评估；该值恒为 null。
  枚举tameviolentbrutal
- widthintegerint64 必填可空
  像素宽度。未知则为 null。
genderstring
在 view=full 时出现。未记录则为 null。
枚举malefemaleother
height_cmintegerint64
在 view=full 时出现。未记录则为 null。
idstring 必填
catalog 角色 id。
imageobject
- hashstring 必填
  图床内容哈希。
- heightintegerint64 必填可空
  像素高度。未知则为 null。
- sexualstring 必填可空
  性描写。null 表示未评估。
  枚举safesuggestiveexplicit
- sourcestring 必填
  开放词表来源。不得用作判别条件。
- thumbhashstring 必填可空
  Thumbhash。未知则为 null。
- urlstringuri 必填
  图片的绝对 URL。从不为裸 hash。
- violencestring 必填可空
  暴力描写。null 表示未评估。目前没有任何 catalog 行经过评估；该值恒为 null。
  枚举tameviolentbrutal
- widthintegerint64 必填可空
  像素宽度。未知则为 null。
instance_of_idstring
本行所实例化的另一角色。在 view=full 时出现。没有则为 null。
introsobject[]
角色描述，每种语言一条。在 include=intros 时出现，仅详情面。没有则为空数组。
- is_machineboolean 必填
  该简介是否机翻。
- langstringbcp47 必填
  BCP-47 语言标签。
- sourcestring 必填
  开放词表来源。不得用作判别条件。
- valuestring 必填
  不得用作判别条件。
langstringbcp47 必填可空
display_name 的 BCP-47 语言标签。未记录则为 null。不得用作判别条件。
latinstring 必填可空
未记录则为 null。不得用作判别条件。
localizedmap<string, object> 必填
BCP-47 键。没有则为空对象。不得用作判别条件。
- «key»object
measurementsobject
- bust_cmintegerint64 必填可空
  未记录则为 null。
- cupstring 必填可空
  不得用作判别条件。未记录则为 null。
- hip_cmintegerint64 必填可空
  未记录则为 null。
- waist_cmintegerint64 必填可空
  未记录则为 null。
objectstring 必填
类型判别字段。恒为 character。
枚举character
refsobject[]
此角色的 exact 上游锚。在 include=refs 时出现，仅详情面。没有则为空数组。
- external_idstring 必填
  上游 id 原文。除精确匹配外不得用作判别条件。它是该实体自身粒度上的身份锚，不一定对应可访问页面：credit-name 的 vndb ref 是没有独立页面的 staff-alias id。可浏览 URL 来自 links。
- sourcestring 必填
  开放词表来源。不得用作判别条件。
traitsobject[]
仅当 include=traits 时出现，且仅在详情面。没有则为空数组。
- display_namestring 必填
  不得用作判别条件。
- groupstring 必填可空
  根特征组名称。根特征本身为 null。不得用作判别条件。
- group_localizedmap<string, object> 必填
  根分组的本地化名称，BCP-47 键。没有则为空对象。不得用作判别条件。
- idstring 必填
  catalog 特征 id。
- is_lieboolean 必填
  该 trait 是否为剧情内伪装。
- is_sexualboolean 必填
  该 trait 是否属于性相关族。
- localizedmap<string, object> 必填
  BCP-47 键。没有则为空对象。不得用作判别条件。
- objectstring 必填
  类型判别字段。恒为 character_trait。
  枚举character_trait
- spoilerstring 必填
  本特征在本角色上的剧透等级。
  枚举noneminormajor
weight_kgintegerint64
在 view=full 时出现。未记录则为 null。

请求示例

cURL

curl "https://api.nextmoe.dev/v2/catalog/characters/value" \
  -H "Authorization: Bearer nmk_live_<YOUR_KEY>"