本文へスキップ

キャラクターの一覧

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

レスポンス

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

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

エラーについて読む