本文へスキップ

コミュニティの一覧

GET/v1/communities

1つの言語のコミュニティを、メンバー数、活発さ、作成日の順で返します。種類とカテゴリーで絞り込めます。

リクエスト

Shell
curl "https://api.nogitsu.com/v1/communities?language=en"

パラメーター

  • language

    クエリ必須

    読み取るコミュニティの言語。言語ごとに独自のコミュニティがあります。

    テキスト

    使用できる値entrdefresptitruidjakozh
  • kind

    クエリ任意

    この種類のコミュニティのみ:作品のコミュニティ、トピック掲示板、メンバーが作成したコミュニティ。

    テキスト

    使用できる値workboarduser
  • category

    クエリ任意

    このカテゴリーのコミュニティのみ。

    テキスト

    使用できる値animemangamanhwawebtoongenresfan_artgeneral
  • sort

    クエリ任意

    結果の順序。

    テキスト

    使用できる値membersactivenew

    既定値:members

  • q

    クエリ任意

    検索するテキスト。

    テキスト

  • cursor

    クエリ任意

    前のページの nextCursor の値。最初のページでは省略します。

    テキスト

  • limit

    クエリ任意

    1ページに返す項目数。

    整数

    1〜24既定値:24

レスポンス

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

  • itemsオブジェクトのリスト
    • idテキスト (uuid)
    • slugテキスト
    • languageテキスト
    • kindテキスト
      使用できる値workboarduser
    • nameテキスト
    • iconUrlテキスト (uri)null になる場合あり
    • themeテキスト
      使用できる値violetblueskycyanemeraldgreenyellowamberrosepink
    • isSampletrue または false
    • categoryテキスト
      使用できる値animemangamanhwawebtoongenresfan_artgeneral
    • descriptionテキストnull になる場合あり
    • memberCount整数

      0〜9007199254740991

    • postCount整数

      0〜9007199254740991

    • isAdulttrue または false
  • nextCursorテキストnull になる場合あり

エラー

他の操作と同様に、この操作も無効なパラメーターでは400、何も見つからない場合は404、リクエストが多すぎる場合は429を返すことがあります。すべてのエラーは同じ形式です。

エラーについて読む