Vai al contenuto

Elenca i personaggi

GET/v1/characters

Restituisce l'elenco dei personaggi, per impostazione predefinita dai più popolari, con ricerca per nome e filtri.

Richiesta

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

Parametri

  • q

    queryfacoltativo

    Testo da cercare.

    testo

  • cursor

    queryfacoltativo

    Il valore nextCursor della pagina precedente. Omettilo per la prima pagina.

    testo

  • sort

    queryfacoltativo

    Ordine dei risultati.

    testo

    Valori consentitipopularworksname
  • role

    queryfacoltativo

    Solo personaggi con questo ruolo.

    testo

    Valori consentitimainsupporting
  • medium

    queryfacoltativo

    Solo personaggi che compaiono in opere da guardare (screen) o da leggere (reading).

    testo

    Valori consentitiscreenreading
  • gender

    queryfacoltativo

    Solo personaggi di questo genere.

    testo

    Valori consentitifemalemalenon_binary

Risposta

Una richiesta riuscita risponde 200 con questo JSON:

  • itemselenco di oggetto
    • idtesto (uuid)
    • slugtesto
    • nametesto
    • nativeNametestopuò essere null
    • pathtesto
    • imageoggettopuò essere null
      • urltesto (uri)
      • widthnumero interopuò essere null

        Da 0 a 9007199254740991

      • heightnumero interopuò essere null

        Da 0 a 9007199254740991

      • blurhashtestopuò essere null
      • providertestopuò essere null
        Valori consentitianime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthselenco di numero intero

        Da 0 a 9007199254740991

    • knownForoggettopuò essere null
      • idtesto (uuid)
      • slugtesto
      • mediumtesto
        Valori consentitianimedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormattesto
        Valori consentititvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatustesto
        Valori consentitinot_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titletesto
      • nativeTitletestopuò essere null
      • romanizedTitletestopuò essere null
      • contentRatingtesto
        Valori consentitiunknownall_agesteenmatureadult
      • startYearnumero interopuò essere null

        Da -9007199254740991 a 9007199254740991

      • coveroggettopuò essere null
        • urltesto (uri)
        • widthnumero interopuò essere null

          Da 0 a 9007199254740991

        • heightnumero interopuò essere null

          Da 0 a 9007199254740991

        • blurhashtestopuò essere null
        • providertestopuò essere null
          Valori consentitianime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthselenco di numero intero

          Da 0 a 9007199254740991

      • contentWarningselenco di testo
        Valori consentitiviolencegoresexual-contentsuicide
    • workCountnumero intero

      Da 0 a 9007199254740991

    • roleselenco di testo
    • gendertestopuò essere null
      Valori consentitifemalemalenon_binary
    • establishedoggettopuò essere null
      • datetesto (date)
      • precisiontesto
        Valori consentitidaymonthyearunknown
  • nextCursortestopuò essere null

Errori

Come ogni operazione, questa può rispondere 400 per parametri non validi, 404 quando non trova nulla e 429 quando invii troppe richieste. Tutti gli errori condividono la stessa forma.

Leggi sugli errori