Aller au contenu

Lister les personnages

GET/v1/characters

Renvoie l’annuaire des personnages, les plus populaires en premier par défaut, avec recherche par nom et filtres.

Requête

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

Paramètres

  • q

    requêtefacultatif

    Texte à rechercher.

    texte

  • cursor

    requêtefacultatif

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

    texte

  • sort

    requêtefacultatif

    Ordre des résultats.

    texte

    Valeurs autoriséespopularworksname
  • role

    requêtefacultatif

    Uniquement les personnages ayant ce rôle.

    texte

    Valeurs autoriséesmainsupporting
  • medium

    requêtefacultatif

    Uniquement les personnages qui apparaissent dans des œuvres à regarder (screen) ou à lire (reading).

    texte

    Valeurs autoriséesscreenreading
  • gender

    requêtefacultatif

    Uniquement les personnages de ce sexe.

    texte

    Valeurs autoriséesfemalemalenon_binary

Réponse

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

  • itemsliste de objet
    • idtexte (uuid)
    • slugtexte
    • nametexte
    • nativeNametextepeut être null
    • pathtexte
    • 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

    • knownForobjetpeut être null
      • idtexte (uuid)
      • slugtexte
      • mediumtexte
        Valeurs autoriséesanimedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormattexte
        Valeurs autoriséestvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatustexte
        Valeurs autoriséesnot_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titletexte
      • nativeTitletextepeut être null
      • romanizedTitletextepeut être null
      • contentRatingtexte
        Valeurs autoriséesunknownall_agesteenmatureadult
      • startYearnombre entierpeut être null

        De -9007199254740991 à 9007199254740991

      • coverobjetpeut ê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

      • contentWarningsliste de texte
        Valeurs autoriséesviolencegoresexual-contentsuicide
    • workCountnombre entier

      De 0 à 9007199254740991

    • rolesliste de texte
    • gendertextepeut être null
      Valeurs autoriséesfemalemalenon_binary
    • establishedobjetpeut être null
      • datetexte (date)
      • precisiontexte
        Valeurs autoriséesdaymonthyearunknown
  • 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