Saltar al contenido

Listar los personajes de una obra

GET/v1/works/{id}/characters

Devuelve los personajes de un grupo de roles, como principales o secundarios, con sus actores de voz.

Solicitud

Shell
curl "https://api.nogitsu.com/v1/works/01a0cb02-0a14-7877-911d-5b4dde76df72/characters?group=main"

Parámetros

  • id

    rutaobligatorio

    Identificador del elemento, un UUID.

    texto

  • group

    consultaobligatorio

    Grupo de roles de los personajes.

    texto

    Valores permitidosmainsupportingbackgroundunspecified
  • 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 100Predeterminado: 60

Respuesta

Una solicitud correcta responde 200 con este JSON:

  • itemslista de objeto
    • idtexto (uuid)
    • nametexto
    • nativeNametextopuede ser null
    • roletextopuede ser null
      Valores permitidosmainsupportingbackground
    • 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

    • slugtexto
    • voiceActorslista de objeto
      • slugtexto
      • nametexto
      • languagetexto
      • 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

  • 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