Saltar al contenido

Listar comunidades

GET/v1/communities

Devuelve las comunidades de un idioma por número de miembros, actividad o antigüedad, con filtros por tipo y categoría.

Solicitud

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

Parámetros

  • language

    consultaobligatorio

    Idioma de las comunidades que quieres leer; cada idioma tiene las suyas.

    texto

    Valores permitidosentrdefresptitruidjakozh
  • kind

    consultaopcional

    Solo comunidades de este tipo: la comunidad de una obra, un foro temático o una comunidad creada por un miembro.

    texto

    Valores permitidosworkboarduser
  • category

    consultaopcional

    Solo comunidades de esta categoría.

    texto

    Valores permitidosanimemangamanhwawebtoongenresfan_artgeneral
  • sort

    consultaopcional

    Orden de los resultados.

    texto

    Valores permitidosmembersactivenew

    Predeterminado: members

  • q

    consultaopcional

    Texto que buscar.

    texto

  • cursor

    consultaopcional

    El valor nextCursor de la página anterior. Omítelo para la primera página.

    texto

  • limit

    consultaopcional

    Cuántos elementos devolver en una página.

    número entero

    De 1 a 24Predeterminado: 24

Respuesta

Una solicitud correcta responde 200 con este JSON:

  • itemslista de objeto
    • idtexto (uuid)
    • slugtexto
    • languagetexto
    • kindtexto
      Valores permitidosworkboarduser
    • nametexto
    • iconUrltexto (uri)puede ser null
    • themetexto
      Valores permitidosvioletblueskycyanemeraldgreenyellowamberrosepink
    • isSampletrue o false
    • categorytexto
      Valores permitidosanimemangamanhwawebtoongenresfan_artgeneral
    • descriptiontextopuede ser null
    • memberCountnúmero entero

      De 0 a 9007199254740991

    • postCountnúmero entero

      De 0 a 9007199254740991

    • isAdulttrue o false
  • nextCursortextopuede ser null

Errores

Como todas las operaciones, esta puede responder 400 si los parámetros no son válidos, 404 si no se encuentra nada y 429 si envías demasiadas solicitudes. Todos los errores comparten una misma forma.

Lee sobre los errores