Zum Inhalt springen

Charaktere auflisten

GET/v1/characters

Liefert das Charakterverzeichnis, standardmäßig die beliebtesten zuerst, mit Namenssuche und Filtern.

Anfrage

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

Parameter

  • q

    Queryoptional

    Zu suchender Text.

    Text

  • cursor

    Queryoptional

    Der nextCursor-Wert der vorherigen Seite. Lass ihn für die erste Seite weg.

    Text

  • sort

    Queryoptional

    Reihenfolge der Ergebnisse.

    Text

    Erlaubte Wertepopularworksname
  • role

    Queryoptional

    Nur Charaktere mit dieser Rolle.

    Text

    Erlaubte Wertemainsupporting
  • medium

    Queryoptional

    Nur Charaktere, die in Werken zum Schauen (screen) oder zum Lesen (reading) vorkommen.

    Text

    Erlaubte Wertescreenreading
  • gender

    Queryoptional

    Nur Charaktere dieses Geschlechts.

    Text

    Erlaubte Wertefemalemalenon_binary

Antwort

Eine erfolgreiche Anfrage antwortet mit 200 und diesem JSON:

  • itemsListe von Objekt
    • idText (uuid)
    • slugText
    • nameText
    • nativeNameTextkann null sein
    • pathText
    • imageObjektkann null sein
      • urlText (uri)
      • widthGanzzahlkann null sein

        Von 0 bis 9007199254740991

      • heightGanzzahlkann null sein

        Von 0 bis 9007199254740991

      • blurhashTextkann null sein
      • providerTextkann null sein
        Erlaubte Werteanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthsListe von Ganzzahl

        Von 0 bis 9007199254740991

    • knownForObjektkann null sein
      • idText (uuid)
      • slugText
      • mediumText
        Erlaubte Werteanimedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormatText
        Erlaubte Wertetvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatusText
        Erlaubte Wertenot_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titleText
      • nativeTitleTextkann null sein
      • romanizedTitleTextkann null sein
      • contentRatingText
        Erlaubte Werteunknownall_agesteenmatureadult
      • startYearGanzzahlkann null sein

        Von -9007199254740991 bis 9007199254740991

      • coverObjektkann null sein
        • urlText (uri)
        • widthGanzzahlkann null sein

          Von 0 bis 9007199254740991

        • heightGanzzahlkann null sein

          Von 0 bis 9007199254740991

        • blurhashTextkann null sein
        • providerTextkann null sein
          Erlaubte Werteanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidthsListe von Ganzzahl

          Von 0 bis 9007199254740991

      • contentWarningsListe von Text
        Erlaubte Werteviolencegoresexual-contentsuicide
    • workCountGanzzahl

      Von 0 bis 9007199254740991

    • rolesListe von Text
    • genderTextkann null sein
      Erlaubte Wertefemalemalenon_binary
    • establishedObjektkann null sein
      • dateText (date)
      • precisionText
        Erlaubte Wertedaymonthyearunknown
  • nextCursorTextkann null sein

Fehler

Wie jede Operation kann auch diese mit 400 bei ungültigen Parametern antworten, mit 404, wenn nichts gefunden wird, und mit 429, wenn du zu viele Anfragen sendest. Alle Fehler haben dieselbe Form.

Mehr über Fehler