跳到主要内容

列出作品的角色

GET/v1/works/{id}/characters

返回某个角色分组(例如主要角色或配角)的角色及其声优。

请求

Shell
curl "https://api.nogitsu.com/v1/works/01a0cb02-0a14-7877-911d-5b4dde76df72/characters?group=main"

参数

  • id

    路径必填

    条目的 ID,为 UUID。

    文本

  • group

    查询必填

    角色的角色分组。

    文本

    允许的值mainsupportingbackgroundunspecified
  • cursor

    查询可选

    上一页的 nextCursor 值。读取第一页时省略。

    文本

  • limit

    查询可选

    每页返回的条目数。

    整数

    1 到 100默认值:60

响应

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

  • items对象 列表
    • id文本 (uuid)
    • name文本
    • nativeName文本可为 null
    • role文本可为 null
      允许的值mainsupportingbackground
    • 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

    • slug文本
    • voiceActors对象 列表
      • slug文本
      • name文本
      • language文本
      • 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

  • nextCursor文本可为 null

错误

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

了解错误