本文へスキップ

作品のキャラクターの一覧

GET/v1/works/{id}/characters

メインや脇役など、1つの役割グループのキャラクターを声優とともに返します。

リクエスト

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ページに返す項目数。

    整数

    1〜100既定値：60

レスポンス

リクエストが成功すると、次のJSONとともに200が返ります。

  • 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を返すことがあります。すべてのエラーは同じ形式です。

エラーについて読む