Aller au contenu

Lister les communautés

GET/v1/communities

Renvoie les communautés d’une langue par nombre de membres, activité ou ancienneté, avec des filtres par type et catégorie.

Requête

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

Paramètres

  • language

    requêteobligatoire

    Langue des communautés à lire ; chaque langue a les siennes.

    texte

    Valeurs autoriséesentrdefresptitruidjakozh
  • kind

    requêtefacultatif

    Uniquement les communautés de ce type : la communauté d’une œuvre, un forum thématique ou une communauté créée par un membre.

    texte

    Valeurs autoriséesworkboarduser
  • category

    requêtefacultatif

    Uniquement les communautés de cette catégorie.

    texte

    Valeurs autoriséesanimemangamanhwawebtoongenresfan_artgeneral
  • sort

    requêtefacultatif

    Ordre des résultats.

    texte

    Valeurs autoriséesmembersactivenew

    Par défaut : members

  • q

    requêtefacultatif

    Texte à rechercher.

    texte

  • cursor

    requêtefacultatif

    La valeur nextCursor de la page précédente. Omettez-la pour la première page.

    texte

  • limit

    requêtefacultatif

    Nombre d’éléments à renvoyer sur une page.

    nombre entier

    De 1 à 24Par défaut : 24

Réponse

Une requête réussie répond 200 avec ce JSON :

  • itemsliste de objet
    • idtexte (uuid)
    • slugtexte
    • languagetexte
    • kindtexte
      Valeurs autoriséesworkboarduser
    • nametexte
    • iconUrltexte (uri)peut être null
    • themetexte
      Valeurs autoriséesvioletblueskycyanemeraldgreenyellowamberrosepink
    • isSampletrue ou false
    • categorytexte
      Valeurs autoriséesanimemangamanhwawebtoongenresfan_artgeneral
    • descriptiontextepeut être null
    • memberCountnombre entier

      De 0 à 9007199254740991

    • postCountnombre entier

      De 0 à 9007199254740991

    • isAdulttrue ou false
  • nextCursortextepeut être null

Erreurs

Comme toutes les opérations, celle-ci peut répondre 400 en cas de paramètres invalides, 404 lorsque rien n’est trouvé et 429 lorsque vous envoyez trop de requêtes. Toutes les erreurs partagent la même forme.

En savoir plus sur les erreurs