Zum Inhalt springen

Communitys auflisten

GET/v1/communities

Liefert die Communitys einer Sprache nach Mitgliederzahl, Aktivität oder Alter, mit Filtern nach Art und Kategorie.

Anfrage

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

Parameter

  • language

    Queryerforderlich

    Sprache der zu lesenden Communitys; jede Sprache hat ihre eigenen.

    Text

    Erlaubte Werteentrdefresptitruidjakozh
  • kind

    Queryoptional

    Nur Communitys dieser Art: die Community eines Werks, ein Themenforum oder eine von einem Mitglied gegründete Community.

    Text

    Erlaubte Werteworkboarduser
  • category

    Queryoptional

    Nur Communitys in dieser Kategorie.

    Text

    Erlaubte Werteanimemangamanhwawebtoongenresfan_artgeneral
  • sort

    Queryoptional

    Reihenfolge der Ergebnisse.

    Text

    Erlaubte Wertemembersactivenew

    Standard: members

  • q

    Queryoptional

    Zu suchender Text.

    Text

  • cursor

    Queryoptional

    Der nextCursor-Wert der vorherigen Seite. Lass ihn für die erste Seite weg.

    Text

  • limit

    Queryoptional

    Wie viele Elemente eine Seite liefern soll.

    Ganzzahl

    Von 1 bis 24Standard: 24

Antwort

Eine erfolgreiche Anfrage antwortet mit 200 und diesem JSON:

  • itemsListe von Objekt
    • idText (uuid)
    • slugText
    • languageText
    • kindText
      Erlaubte Werteworkboarduser
    • nameText
    • iconUrlText (uri)kann null sein
    • themeText
      Erlaubte Wertevioletblueskycyanemeraldgreenyellowamberrosepink
    • isSampletrue oder false
    • categoryText
      Erlaubte Werteanimemangamanhwawebtoongenresfan_artgeneral
    • descriptionTextkann null sein
    • memberCountGanzzahl

      Von 0 bis 9007199254740991

    • postCountGanzzahl

      Von 0 bis 9007199254740991

    • isAdulttrue oder false
  • nextCursorTextkann null sein

Fehler

Wie jede Operation kann auch diese mit 400 bei ungültigen Parametern antworten, mit 404, wenn nichts gefunden wird, und mit 429, wenn du zu viele Anfragen sendest. Alle Fehler haben dieselbe Form.

Mehr über Fehler