Zum Inhalt springen

Rezensionen eines Werks auflisten

GET/v1/works/{id}/reviews

Liefert die veröffentlichten Rezensionen eines Werks, sortiert nach Hilfreichkeit, Datum oder Wertung, mit Filtern.

Anfrage

Shell
curl "https://api.nogitsu.com/v1/works/01a0cb02-0a14-7877-911d-5b4dde76df72/reviews"

Parameter

  • id

    Pfaderforderlich

    ID des Elements, eine UUID.

    Text

  • sort

    Queryoptional

    Reihenfolge der Ergebnisse.

    Text

    Erlaubte Wertehelpfulnewesthighestlowest

    Standard: helpful

  • score

    Queryoptional

    Nur Rezensionen, die diese Wertung vergeben.

    Ganzzahl

    Von 1 bis 10

  • language

    Queryoptional

    Nur Rezensionen, die in dieser Sprache geschrieben sind.

    Text

  • completedOnly

    Queryoptional

    true, um nur Rezensionen von Mitgliedern zu erhalten, die das Werk beendet haben.

    Text

  • detailed

    Queryoptional

    true, um nur lange Rezensionen mit 600 oder mehr Zeichen zu erhalten.

    Text

  • cursor

    Queryoptional

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

    Text

  • limit

    Queryoptional

    Wie viele Elemente eine Seite liefern soll.

    Ganzzahl

    Von 1 bis 20Standard: 20

Antwort

Eine erfolgreiche Anfrage antwortet mit 200 und diesem JSON:

  • itemsListe von Objekt
    • idText (uuid)
    • authorObjekt
      • usernameText
      • displayNameText
      • avatarUrlText (uri)kann null sein
    • titleTextkann null sein
    • bodyObjektkann null sein
      • blocksListe von eine von mehreren Formen

        1. Option 1

          • typeText
            Erlaubte Werteparagraph
          • childrenListe von eine von mehreren Formen

            1. Option 1

            2. Option 2

            3. Option 3

            4. Option 4

            5. Option 5

        2. Option 2

          • typeText
            Erlaubte Werteheading
          • childrenListe von eine von mehreren Formen

            1. Option 1

            2. Option 2

            3. Option 3

            4. Option 4

            5. Option 5

        3. Option 3

          • typeText
            Erlaubte Wertequote
          • childrenListe von RichTextBlock

        4. Option 4

          • typeText
            Erlaubte Wertelist
          • isOrderedtrue oder false
          • itemsListe von Liste von RichTextBlock

        5. Option 5

          • typeText
            Erlaubte Wertecode
          • textText
    • bodyLengthGanzzahl

      Von 0 bis 9007199254740991

    • hasSpoilertrue oder false
    • spoilerUnitZahlkann null sein

      Mindestens 0

    • sourceSpoilerObjektkann null sein
      • kindText
        Erlaubte Wertemangamanhwamanhuawebtoonnovelother
      • unitZahlkann null sein

        Mindestens 0

    • prosListe von Textkann null sein
    • consListe von Textkann null sein
    • imagesListe von Objekt
      • urlText (uri)
      • widthGanzzahl

        Von 0 bis 9007199254740991

      • heightGanzzahl

        Von 0 bis 9007199254740991

      • altTextkann null sein
      • variantWidthsListe von Ganzzahl

        Von 0 bis 9007199254740991

    • languageText
    • scoreHalfPointsGanzzahlkann null sein

      Von 1 bis 20

    • categoryScoresObjekt
    • trackingStatusTextkann null sein
      Erlaubte Werteplannedcurrentcompletedpauseddroppedrewatching
    • progressUnitsZahlkann null sein

      Mindestens 0

    • progressTotalGanzzahlkann null sein

      Von 0 bis 9007199254740991

    • repeatCountGanzzahl

      Von 0 bis 9007199254740991

    • authorStatsObjekt
      • reviewCountGanzzahl

        Von 0 bis 9007199254740991

      • helpfulCountGanzzahl

        Von 0 bis 9007199254740991

    • helpfulCountGanzzahl

      Von 0 bis 9007199254740991

    • unhelpfulCountGanzzahl

      Von 0 bis 9007199254740991

    • replyCountGanzzahl

      Von 0 bis 9007199254740991

    • createdAtText (date-time)
    • editedAtText (date-time)kann null sein
  • 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