角色详情

GET/v3/characters/{id}catalog:read

调试

未配置令牌设置令牌后才能发送请求

响应字段

age *number | null年龄

aliases *string[]别名列表

birthday_day *number | null生日日

birthday_month *number | null生日月份

blood_type *string | null血型

bust *number | null胸围，单位厘米

created_at *string条目创建时间

cup *string | null罩杯

en_intro *string | null英文简介

en_name *string | null英文名或罗马字

external_source OpenExternalSourceDto外部数据源 ID，仅 catalog:sync 客户端返回；无该 scope 时省略此字段

gender *string | null性别

height *number | null身高，单位厘米

hips *number | null臀围，单位厘米

id *number角色 ID

image *OpenMediaDto | null角色头像

intro *string原文简介

labels *OpenEntityLabelDto[]补充信息标签，键值对形式

name *string原名

revised_at *string | null最近一次修订通过审核的时间

trans_intro *string | null简介译文

trans_name *string | null译名

updated_at *string条目最后更新时间

waist *number | null腰围，单位厘米

weight *number | null体重，单位千克

示例

curl "https://api.hikarinagi.org/v3/characters/1" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

响应示例

{
  "age": 1,
  "aliases": [
    "string"
  ],
  "birthday_day": 1,
  "birthday_month": 1,
  "blood_type": "string",
  "bust": 1,
  "created_at": "2026-08-02T00:00:00.000Z",
  "cup": "string",
  "en_intro": "string",
  "en_name": "string",
  "external_source": {
    "bangumi": "string",
    "vndb": "string"
  },
  "gender": "string",
  "height": 1,
  "hips": 1,
  "id": 1,
  "image": {
    "height": 1,
    "sexual": 1,
    "url": "path/to/asset.jpg",
    "violence": 1,
    "width": 1
  },
  "intro": "string",
  "labels": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "name": "string",
  "revised_at": "2026-08-02T00:00:00.000Z",
  "trans_intro": "string",
  "trans_name": "string",
  "updated_at": "2026-08-02T00:00:00.000Z",
  "waist": 1,
  "weight": 1
}

响应状态

200成功