文档 API v2getCatalogTrait

getCatalogTrait

获取一条特征

一条角色特征词表行。未带 nsfw=true 时，性相关族特征返回 404 NOT_FOUND。include=aliases,description,intros（以及 view=full）加入对应块。include=character_count 是夜间索引上 GET /v2/catalog/characters?trait_id=<本 id>&page=1 在本请求 nsfw 下给出的总数；引擎失败为 503。这是显式请求：view=full 不会带上它。is_sexual 报告性相关族标志。可匿名调用，按 IP 地址限流；应用密钥或带 catalog:read 的用户访问令牌各有更高的额度。

get/v2/catalog/traits/{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 始终保留。

响应

aliasesstring[]
仅当 include=aliases 时出现。按换行切分、去空白、去重。没有则为空数组。
character_countintegerint64
在 include=character_count 时出现。即 GET /v2/catalog/characters?trait_id=<本 id>&page=1 在本请求 nsfw 下给出的总数（含子孙，spoiler none），来自同一夜间搜索索引。
child_countintegerint64 必填
在本请求 nsfw 门下可见的直接子节点数。
descriptionstring
仅当 include=description 时出现。去掉 VNDB 标记后的纯文本。未记录则为空。不得用作判别条件。
display_namestring 必填
不得用作判别条件。
groupstring 必填可空
根特征组名称。根特征本身为 null。不得用作判别条件。
group_idstring 必填可空
根分组的目录属性 id。根属性本身为 null。
group_localizedmap<string, object> 必填
根分组的本地化名称，BCP-47 键。没有则为空对象。不得用作判别条件。
- «key»object
idstring 必填
catalog 特征 id。
introsobject[]
仅当 include=intros 时出现。特征释义，每种语言一条：en 为 description 的纯文本，已记录时另有 zh-Hans。没有则为空数组。
- is_machineboolean 必填
  该简介是否机翻。
- langstringbcp47 必填
  BCP-47 语言标签。
- sourcestring 必填
  开放词表来源。不得用作判别条件。
- valuestring 必填
  不得用作判别条件。
is_applicableboolean 必填
该特征是否可应用到角色。
is_searchableboolean 必填
该特征是否可搜索。
is_sexualboolean 必填
该 trait 是否属于性相关族。
localizedmap<string, object> 必填
BCP-47 键。没有则为空对象。不得用作判别条件。
- «key»object
name_zhstring 必填
不得用作判别条件。未记录则为空。
objectstring 必填
类型判别字段。恒为 trait。
枚举trait
parentsobject[] 必填
直接父节点，按 id 排序。根特征为空数组。永不为 null。
- display_namestring 必填
  不得用作判别条件。
- idstring 必填
  catalog 特征 id。
- localizedmap<string, object> 必填
  BCP-47 键。没有则为空对象。不得用作判别条件。
- objectstring 必填
  类型判别字段。恒为 trait。
  枚举trait
root_orderintegerint64 必填可空
根特征的 gorder（1-11）。非根均为 null。
vndb_tidstring 必填
上游 VNDB trait id。不得用作判别条件。

请求示例

cURL

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