列出角色

GET/v1/characters

返回角色目录，默认按热度排序，支持名称搜索和筛选。

请求

Shell

curl "https://api.nogitsu.com/v1/characters?q=mikasa"

参数

q
查询可选
要搜索的文本。
文本
cursor
查询可选
上一页的 nextCursor 值。读取第一页时省略。
文本
sort
查询可选
结果的排序方式。
文本
允许的值popularworksname
role
查询可选
仅限担任此角色定位的角色。
文本
允许的值mainsupporting
medium
查询可选
仅限出现在可观看作品（screen）或可阅读作品（reading）中的角色。
文本
允许的值screenreading
gender
查询可选
仅限此性别的角色。
文本
允许的值femalemalenon_binary

响应

请求成功时返回 200 和以下 JSON：

items对象列表
- id文本 (uuid)
- slug文本
- name文本
- nativeName文本可为 null
- path文本
- image对象可为 null
  url文本 (uri)
  width整数可为 null
  0 到 9007199254740991
  height整数可为 null
  0 到 9007199254740991
  blurhash文本可为 null
  provider文本可为 null
  允许的值anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidths整数列表
  0 到 9007199254740991
- knownFor对象可为 null
  id文本 (uuid)
  slug文本
  medium文本
  允许的值animedonghuaanimationmangamanhwamanhuawebtoon
  publicationFormat文本
  允许的值tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
  releaseStatus文本
  允许的值not_yet_releasedreleasingfinishedhiatuscancelledunknown
  title文本
  nativeTitle文本可为 null
  romanizedTitle文本可为 null
  contentRating文本
  允许的值unknownall_agesteenmatureadult
  startYear整数可为 null
  -9007199254740991 到 9007199254740991
  cover对象可为 null
  url文本 (uri)
  width整数可为 null
  0 到 9007199254740991
  height整数可为 null
  0 到 9007199254740991
  blurhash文本可为 null
  provider文本可为 null
  允许的值anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidths整数列表
  0 到 9007199254740991
  contentWarnings文本列表
  允许的值violencegoresexual-contentsuicide
- workCount整数
  0 到 9007199254740991
- roles文本列表
- gender文本可为 null
  允许的值femalemalenon_binary
- established对象可为 null
  date文本 (date)
  precision文本
  允许的值daymonthyearunknown
nextCursor文本可为 null

错误

与所有操作一样，此操作在参数无效时可能返回 400，找不到内容时返回 404，请求过多时返回 429。所有错误的结构都相同。

了解错误