Obtenir la synthèse des critiques d’une œuvre

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

Renvoie le nombre de critiques et de notes, la note moyenne, la répartition des notes, les moyennes par catégorie et les points forts et points faibles les plus cités par les auteurs de critiques.

Requête

Shell

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

Paramètres

id
cheminobligatoire
Identifiant de l’élément, un UUID.
texte

Réponse

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

reviewCountnombre entier
De 0 à 9007199254740991
ratingCountnombre entier
De 0 à 9007199254740991
averageHalfPointsnombrepeut être null
scoreBucketsliste de nombre entier
De 0 à 9007199254740991
categoriesliste de objet
- categorytexte
  Valeurs autoriséesstorycharactersvisualssoundenjoyment
- averageHalfPointsnombre
- scoreCountnombre entier
  De 0 à 9007199254740991
topPraisedCategorytextepeut être null
Valeurs autoriséesstorycharactersvisualssoundenjoyment
themesliste de objet
- kindtexte
  Valeurs autoriséesprocon
- labeltexte
- countnombre entier
  De 0 à 9007199254740991
languagesliste de texte

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