Lister les critiques d’une œuvre

GET/v1/works/{id}/reviews

Renvoie les critiques publiées d’une œuvre, triées par utilité, date ou note, avec des filtres.

Requête

Shell

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

Paramètres

id
cheminobligatoire
Identifiant de l’élément, un UUID.
texte
sort
requêtefacultatif
Ordre des résultats.
texte
Valeurs autoriséeshelpfulnewesthighestlowest
Par défaut : helpful
score
requêtefacultatif
Uniquement les critiques qui attribuent cette note.
nombre entier
De 1 à 10
language
requêtefacultatif
Uniquement les critiques rédigées dans cette langue.
texte
completedOnly
requêtefacultatif
true pour n’obtenir que les critiques de membres ayant terminé l’œuvre.
texte
detailed
requêtefacultatif
true pour n’obtenir que les critiques longues, de 600 caractères ou plus.
texte
cursor
requêtefacultatif
La valeur nextCursor de la page précédente. Omettez-la pour la première page.
texte
limit
requêtefacultatif
Nombre d’éléments à renvoyer sur une page.
nombre entier
De 1 à 20Par défaut : 20

Réponse

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

itemsliste de objet
- idtexte (uuid)
- authorobjet
  usernametexte
  displayNametexte
  avatarUrltexte (uri)peut être null
- titletextepeut être null
- bodyobjetpeut être null
  blocksliste de l’une de plusieurs formes
  Option 1
  typetexte
  Valeurs autoriséesparagraph
  childrenliste de l’une de plusieurs formes
  Option 1
  Option 2
  Option 3
  Option 4
  Option 5
  Option 2
  typetexte
  Valeurs autoriséesheading
  childrenliste de l’une de plusieurs formes
  Option 1
  Option 2
  Option 3
  Option 4
  Option 5
  Option 3
  typetexte
  Valeurs autoriséesquote
  childrenliste de RichTextBlock
  Option 4
  typetexte
  Valeurs autoriséeslist
  isOrderedtrue ou false
  itemsliste de liste de RichTextBlock
  Option 5
  typetexte
  Valeurs autoriséescode
  texttexte
- bodyLengthnombre entier
  De 0 à 9007199254740991
- hasSpoilertrue ou false
- spoilerUnitnombrepeut être null
  Au moins 0
- sourceSpoilerobjetpeut être null
  kindtexte
  Valeurs autoriséesmangamanhwamanhuawebtoonnovelother
  unitnombrepeut être null
  Au moins 0
- prosliste de textepeut être null
- consliste de textepeut être null
- imagesliste de objet
  urltexte (uri)
  widthnombre entier
  De 0 à 9007199254740991
  heightnombre entier
  De 0 à 9007199254740991
  alttextepeut être null
  variantWidthsliste de nombre entier
  De 0 à 9007199254740991
- languagetexte
- scoreHalfPointsnombre entierpeut être null
  De 1 à 20
- categoryScoresobjet
- trackingStatustextepeut être null
  Valeurs autoriséesplannedcurrentcompletedpauseddroppedrewatching
- progressUnitsnombrepeut être null
  Au moins 0
- progressTotalnombre entierpeut être null
  De 0 à 9007199254740991
- repeatCountnombre entier
  De 0 à 9007199254740991
- authorStatsobjet
  reviewCountnombre entier
  De 0 à 9007199254740991
  helpfulCountnombre entier
  De 0 à 9007199254740991
- helpfulCountnombre entier
  De 0 à 9007199254740991
- unhelpfulCountnombre entier
  De 0 à 9007199254740991
- replyCountnombre entier
  De 0 à 9007199254740991
- createdAttexte (date-time)
- editedAttexte (date-time)peut être null
nextCursortextepeut être null

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