Pular para o conteúdo

Listar personagens

GET/v1/characters

Retorna o diretório de personagens, por padrão os mais populares primeiro, com busca por nome e filtros.

Requisição

Shell
curl "https://api.nogitsu.com/v1/characters?q=mikasa"

Parâmetros

  • q

    consultaopcional

    Texto a buscar.

    texto

  • cursor

    consultaopcional

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

    texto

  • sort

    consultaopcional

    Ordem dos resultados.

    texto

    Valores permitidospopularworksname
  • role

    consultaopcional

    Apenas personagens com este papel.

    texto

    Valores permitidosmainsupporting
  • medium

    consultaopcional

    Apenas personagens que aparecem em obras para assistir (screen) ou para ler (reading).

    texto

    Valores permitidosscreenreading
  • gender

    consultaopcional

    Apenas personagens deste gênero.

    texto

    Valores permitidosfemalemalenon_binary

Resposta

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

  • itemslista de objeto
    • idtexto (uuid)
    • slugtexto
    • nametexto
    • nativeNametextopode ser null
    • pathtexto
    • imageobjetopode ser null
      • urltexto (uri)
      • widthnúmero inteiropode ser null

        De 0 a 9007199254740991

      • heightnúmero inteiropode ser null

        De 0 a 9007199254740991

      • blurhashtextopode ser null
      • providertextopode ser null
        Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthslista de número inteiro

        De 0 a 9007199254740991

    • knownForobjetopode ser null
      • idtexto (uuid)
      • slugtexto
      • mediumtexto
        Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormattexto
        Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatustexto
        Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titletexto
      • nativeTitletextopode ser null
      • romanizedTitletextopode ser null
      • contentRatingtexto
        Valores permitidosunknownall_agesteenmatureadult
      • startYearnúmero inteiropode ser null

        De -9007199254740991 a 9007199254740991

      • coverobjetopode ser null
        • urltexto (uri)
        • widthnúmero inteiropode ser null

          De 0 a 9007199254740991

        • heightnúmero inteiropode ser null

          De 0 a 9007199254740991

        • blurhashtextopode ser null
        • providertextopode ser null
          Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthslista de número inteiro

          De 0 a 9007199254740991

      • contentWarningslista de texto
        Valores permitidosviolencegoresexual-contentsuicide
    • workCountnúmero inteiro

      De 0 a 9007199254740991

    • roleslista de texto
    • gendertextopode ser null
      Valores permitidosfemalemalenon_binary
    • establishedobjetopode ser null
      • datetexto (date)
      • precisiontexto
        Valores permitidosdaymonthyearunknown
  • 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