Zum Inhalt springen

Rezensionsübersicht eines Werks abrufen

GET/v1/works/{id}/reviews/summary

Liefert die Zahl der Rezensionen und Bewertungen, die Durchschnittswertung, die Wertungsverteilung, die Durchschnitte je Kategorie und die Pro- und Contra-Punkte, die Rezensenten am häufigsten nennen.

Anfrage

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

Parameter

  • id

    Pfaderforderlich

    ID des Elements, eine UUID.

    Text

Antwort

Eine erfolgreiche Anfrage antwortet mit 200 und diesem JSON:

  • reviewCountGanzzahl

    Von 0 bis 9007199254740991

  • ratingCountGanzzahl

    Von 0 bis 9007199254740991

  • averageHalfPointsZahlkann null sein
  • scoreBucketsListe von Ganzzahl

    Von 0 bis 9007199254740991

  • categoriesListe von Objekt
    • categoryText
      Erlaubte Wertestorycharactersvisualssoundenjoyment
    • averageHalfPointsZahl
    • scoreCountGanzzahl

      Von 0 bis 9007199254740991

  • topPraisedCategoryTextkann null sein
    Erlaubte Wertestorycharactersvisualssoundenjoyment
  • themesListe von Objekt
    • kindText
      Erlaubte Werteprocon
    • labelText
    • countGanzzahl

      Von 0 bis 9007199254740991

  • languagesListe von Text

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