Listar las reseñas de una obra

GET/v1/works/{id}/reviews

Devuelve las reseñas publicadas de una obra, ordenadas por utilidad, fecha o puntuación, con filtros.

Solicitud

Shell

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

Parámetros

id
rutaobligatorio
Identificador del elemento, un UUID.
texto
sort
consultaopcional
Orden de los resultados.
texto
Valores permitidoshelpfulnewesthighestlowest
Predeterminado: helpful
score
consultaopcional
Solo reseñas que dan esta puntuación.
número entero
De 1 a 10
language
consultaopcional
Solo reseñas escritas en este idioma.
texto
completedOnly
consultaopcional
true para obtener solo reseñas de miembros que terminaron la obra.
texto
detailed
consultaopcional
true para obtener solo reseñas largas, de 600 caracteres o más.
texto
cursor
consultaopcional
El valor nextCursor de la página anterior. Omítelo para la primera página.
texto
limit
consultaopcional
Cuántos elementos devolver en una página.
número entero
De 1 a 20Predeterminado: 20

Respuesta

Una solicitud correcta responde 200 con este JSON:

itemslista de objeto
- idtexto (uuid)
- authorobjeto
  usernametexto
  displayNametexto
  avatarUrltexto (uri)puede ser null
- titletextopuede ser null
- bodyobjetopuede ser null
  blockslista de una de varias formas
  Opción 1
  typetexto
  Valores permitidosparagraph
  childrenlista de una de varias formas
  Opción 1
  Opción 2
  Opción 3
  Opción 4
  Opción 5
  Opción 2
  typetexto
  Valores permitidosheading
  childrenlista de una de varias formas
  Opción 1
  Opción 2
  Opción 3
  Opción 4
  Opción 5
  Opción 3
  typetexto
  Valores permitidosquote
  childrenlista de RichTextBlock
  Opción 4
  typetexto
  Valores permitidoslist
  isOrderedtrue o false
  itemslista de lista de RichTextBlock
  Opción 5
  typetexto
  Valores permitidoscode
  texttexto
- bodyLengthnúmero entero
  De 0 a 9007199254740991
- hasSpoilertrue o false
- spoilerUnitnúmeropuede ser null
  Al menos 0
- sourceSpoilerobjetopuede ser null
  kindtexto
  Valores permitidosmangamanhwamanhuawebtoonnovelother
  unitnúmeropuede ser null
  Al menos 0
- proslista de textopuede ser null
- conslista de textopuede ser null
- imageslista de objeto
  urltexto (uri)
  widthnúmero entero
  De 0 a 9007199254740991
  heightnúmero entero
  De 0 a 9007199254740991
  alttextopuede ser null
  variantWidthslista de número entero
  De 0 a 9007199254740991
- languagetexto
- scoreHalfPointsnúmero enteropuede ser null
  De 1 a 20
- categoryScoresobjeto
- trackingStatustextopuede ser null
  Valores permitidosplannedcurrentcompletedpauseddroppedrewatching
- progressUnitsnúmeropuede ser null
  Al menos 0
- progressTotalnúmero enteropuede ser null
  De 0 a 9007199254740991
- repeatCountnúmero entero
  De 0 a 9007199254740991
- authorStatsobjeto
  reviewCountnúmero entero
  De 0 a 9007199254740991
  helpfulCountnúmero entero
  De 0 a 9007199254740991
- helpfulCountnúmero entero
  De 0 a 9007199254740991
- unhelpfulCountnúmero entero
  De 0 a 9007199254740991
- replyCountnúmero entero
  De 0 a 9007199254740991
- createdAttexto (date-time)
- editedAttexto (date-time)puede ser null
nextCursortextopuede ser null

Errores

Como todas las operaciones, esta puede responder 400 si los parámetros no son válidos, 404 si no se encuentra nada y 429 si envías demasiadas solicitudes. Todos los errores comparten una misma forma.

Lee sobre los errores