Pular para o conteúdo

Listar comunidades

GET/v1/communities

Retorna as comunidades de um idioma por número de membros, atividade ou idade, com filtros por tipo e categoria.

Requisição

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

Parâmetros

  • language

    consultaobrigatório

    Idioma das comunidades a ler; cada idioma tem as suas.

    texto

    Valores permitidosentrdefresptitruidjakozh
  • kind

    consultaopcional

    Apenas comunidades deste tipo: a comunidade de uma obra, um fórum temático ou uma comunidade criada por um membro.

    texto

    Valores permitidosworkboarduser
  • category

    consultaopcional

    Apenas comunidades desta categoria.

    texto

    Valores permitidosanimemangamanhwawebtoongenresfan_artgeneral
  • sort

    consultaopcional

    Ordem dos resultados.

    texto

    Valores permitidosmembersactivenew

    Padrão: members

  • q

    consultaopcional

    Texto a buscar.

    texto

  • cursor

    consultaopcional

    O valor de nextCursor da página anterior. Omita-o na primeira página.

    texto

  • limit

    consultaopcional

    Quantos itens retornar em uma página.

    número inteiro

    De 1 a 24Padrão: 24

Resposta

Uma requisição bem-sucedida responde 200 com este JSON:

  • itemslista de objeto
    • idtexto (uuid)
    • slugtexto
    • languagetexto
    • kindtexto
      Valores permitidosworkboarduser
    • nametexto
    • iconUrltexto (uri)pode ser null
    • themetexto
      Valores permitidosvioletblueskycyanemeraldgreenyellowamberrosepink
    • isSampletrue ou false
    • categorytexto
      Valores permitidosanimemangamanhwawebtoongenresfan_artgeneral
    • descriptiontextopode ser null
    • memberCountnúmero inteiro

      De 0 a 9007199254740991

    • postCountnúmero inteiro

      De 0 a 9007199254740991

    • isAdulttrue ou false
  • nextCursortextopode ser null

Erros

Como toda operação, esta pode responder 400 para parâmetros inválidos, 404 quando nada é encontrado e 429 quando você envia requisições demais. Todos os erros compartilham o mesmo formato.

Leia sobre erros