Saltar al contenido

Listar personajes

GET/v1/characters

Devuelve el directorio de personajes, por defecto primero los más populares, con búsqueda por nombre y filtros.

Solicitud

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

Parámetros

  • q

    consultaopcional

    Texto que buscar.

    texto

  • cursor

    consultaopcional

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

    texto

  • sort

    consultaopcional

    Orden de los resultados.

    texto

    Valores permitidospopularworksname
  • role

    consultaopcional

    Solo personajes con este rol.

    texto

    Valores permitidosmainsupporting
  • medium

    consultaopcional

    Solo personajes que aparecen en obras para ver (screen) o para leer (reading).

    texto

    Valores permitidosscreenreading
  • gender

    consultaopcional

    Solo personajes de este género.

    texto

    Valores permitidosfemalemalenon_binary

Respuesta

Una solicitud correcta responde 200 con este JSON:

  • itemslista de objeto
    • idtexto (uuid)
    • slugtexto
    • nametexto
    • nativeNametextopuede ser null
    • pathtexto
    • imageobjetopuede ser null
      • urltexto (uri)
      • widthnúmero enteropuede ser null

        De 0 a 9007199254740991

      • heightnúmero enteropuede ser null

        De 0 a 9007199254740991

      • blurhashtextopuede ser null
      • providertextopuede ser null
        Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthslista de número entero

        De 0 a 9007199254740991

    • knownForobjetopuede ser null
      • idtexto (uuid)
      • slugtexto
      • mediumtexto
        Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormattexto
        Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatustexto
        Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titletexto
      • nativeTitletextopuede ser null
      • romanizedTitletextopuede ser null
      • contentRatingtexto
        Valores permitidosunknownall_agesteenmatureadult
      • startYearnúmero enteropuede ser null

        De -9007199254740991 a 9007199254740991

      • coverobjetopuede ser null
        • urltexto (uri)
        • widthnúmero enteropuede ser null

          De 0 a 9007199254740991

        • heightnúmero enteropuede ser null

          De 0 a 9007199254740991

        • blurhashtextopuede ser null
        • providertextopuede ser null
          Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthslista de número entero

          De 0 a 9007199254740991

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

      De 0 a 9007199254740991

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