Elenca le recensioni di un'opera

GET/v1/works/{id}/reviews

Restituisce le recensioni pubblicate di un'opera, ordinate per utilità, data o punteggio, con filtri.

Richiesta

Shell

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

Parametri

id
percorsoobbligatorio
Id dell'elemento, un UUID.
testo
sort
queryfacoltativo
Ordine dei risultati.
testo
Valori consentitihelpfulnewesthighestlowest
Predefinito: helpful
score
queryfacoltativo
Solo recensioni che danno questo punteggio.
numero intero
Da 1 a 10
language
queryfacoltativo
Solo recensioni scritte in questa lingua.
testo
completedOnly
queryfacoltativo
true per le sole recensioni di membri che hanno completato l'opera.
testo
detailed
queryfacoltativo
true per le sole recensioni lunghe, di 600 caratteri o più.
testo
cursor
queryfacoltativo
Il valore nextCursor della pagina precedente. Omettilo per la prima pagina.
testo
limit
queryfacoltativo
Quanti elementi restituire in una pagina.
numero intero
Da 1 a 20Predefinito: 20

Risposta

Una richiesta riuscita risponde 200 con questo JSON:

itemselenco di oggetto
- idtesto (uuid)
- authoroggetto
  usernametesto
  displayNametesto
  avatarUrltesto (uri)può essere null
- titletestopuò essere null
- bodyoggettopuò essere null
  blockselenco di una tra più forme
  Opzione 1
  typetesto
  Valori consentitiparagraph
  childrenelenco di una tra più forme
  Opzione 1
  Opzione 2
  Opzione 3
  Opzione 4
  Opzione 5
  Opzione 2
  typetesto
  Valori consentitiheading
  childrenelenco di una tra più forme
  Opzione 1
  Opzione 2
  Opzione 3
  Opzione 4
  Opzione 5
  Opzione 3
  typetesto
  Valori consentitiquote
  childrenelenco di RichTextBlock
  Opzione 4
  typetesto
  Valori consentitilist
  isOrderedtrue o false
  itemselenco di elenco di RichTextBlock
  Opzione 5
  typetesto
  Valori consentiticode
  texttesto
- bodyLengthnumero intero
  Da 0 a 9007199254740991
- hasSpoilertrue o false
- spoilerUnitnumeropuò essere null
  Almeno 0
- sourceSpoileroggettopuò essere null
  kindtesto
  Valori consentitimangamanhwamanhuawebtoonnovelother
  unitnumeropuò essere null
  Almeno 0
- proselenco di testopuò essere null
- conselenco di testopuò essere null
- imageselenco di oggetto
  urltesto (uri)
  widthnumero intero
  Da 0 a 9007199254740991
  heightnumero intero
  Da 0 a 9007199254740991
  alttestopuò essere null
  variantWidthselenco di numero intero
  Da 0 a 9007199254740991
- languagetesto
- scoreHalfPointsnumero interopuò essere null
  Da 1 a 20
- categoryScoresoggetto
- trackingStatustestopuò essere null
  Valori consentitiplannedcurrentcompletedpauseddroppedrewatching
- progressUnitsnumeropuò essere null
  Almeno 0
- progressTotalnumero interopuò essere null
  Da 0 a 9007199254740991
- repeatCountnumero intero
  Da 0 a 9007199254740991
- authorStatsoggetto
  reviewCountnumero intero
  Da 0 a 9007199254740991
  helpfulCountnumero intero
  Da 0 a 9007199254740991
- helpfulCountnumero intero
  Da 0 a 9007199254740991
- unhelpfulCountnumero intero
  Da 0 a 9007199254740991
- replyCountnumero intero
  Da 0 a 9007199254740991
- createdAttesto (date-time)
- editedAttesto (date-time)può essere null
nextCursortestopuò essere null

Errori

Come ogni operazione, questa può rispondere 400 per parametri non validi, 404 quando non trova nulla e 429 quando invii troppe richieste. Tutti gli errori condividono la stessa forma.

Leggi sugli errori