Aller au contenu

Lister les personnages d’une œuvre

GET/v1/works/{id}/characters

Renvoie les personnages d’un groupe de rôles, comme principaux ou secondaires, avec leurs doubleurs.

Requête

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

Paramètres

  • id

    cheminobligatoire

    Identifiant de l’élément, un UUID.

    texte

  • group

    requêteobligatoire

    Groupe de rôles des personnages.

    texte

    Valeurs autoriséesmainsupportingbackgroundunspecified
  • cursor

    requêtefacultatif

    La valeur nextCursor de la page précédente. Omettez-la pour la première page.

    texte

  • limit

    requêtefacultatif

    Nombre d’éléments à renvoyer sur une page.

    nombre entier

    De 1 à 100Par défaut : 60

Réponse

Une requête réussie répond 200 avec ce JSON :

  • itemsliste de objet
    • idtexte (uuid)
    • nametexte
    • nativeNametextepeut être null
    • roletextepeut être null
      Valeurs autoriséesmainsupportingbackground
    • imageobjetpeut être null
      • urltexte (uri)
      • widthnombre entierpeut être null

        De 0 à 9007199254740991

      • heightnombre entierpeut être null

        De 0 à 9007199254740991

      • blurhashtextepeut être null
      • providertextepeut être null
        Valeurs autoriséesanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthsliste de nombre entier

        De 0 à 9007199254740991

    • slugtexte
    • voiceActorsliste de objet
      • slugtexte
      • nametexte
      • languagetexte
      • imageobjetpeut être null
        • urltexte (uri)
        • widthnombre entierpeut être null

          De 0 à 9007199254740991

        • heightnombre entierpeut être null

          De 0 à 9007199254740991

        • blurhashtextepeut être null
        • providertextepeut être null
          Valeurs autoriséesanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthsliste de nombre entier

          De 0 à 9007199254740991

  • nextCursortextepeut être null

Erreurs

Comme toutes les opérations, celle-ci peut répondre 400 en cas de paramètres invalides, 404 lorsque rien n’est trouvé et 429 lorsque vous envoyez trop de requêtes. Toutes les erreurs partagent la même forme.

En savoir plus sur les erreurs