Saltar al contenido

Obtener el resumen de reseñas de una obra

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

Devuelve el número de reseñas y valoraciones, la puntuación media, la distribución de puntuaciones, las medias por categoría y los pros y contras que más mencionan los reseñadores.

Solicitud

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

Parámetros

  • id

    rutaobligatorio

    Identificador del elemento, un UUID.

    texto

Respuesta

Una solicitud correcta responde 200 con este JSON:

  • reviewCountnúmero entero

    De 0 a 9007199254740991

  • ratingCountnúmero entero

    De 0 a 9007199254740991

  • averageHalfPointsnúmeropuede ser null
  • scoreBucketslista de número entero

    De 0 a 9007199254740991

  • categorieslista de objeto
    • categorytexto
      Valores permitidosstorycharactersvisualssoundenjoyment
    • averageHalfPointsnúmero
    • scoreCountnúmero entero

      De 0 a 9007199254740991

  • topPraisedCategorytextopuede ser null
    Valores permitidosstorycharactersvisualssoundenjoyment
  • themeslista de objeto
    • kindtexto
      Valores permitidosprocon
    • labeltexto
    • countnúmero entero

      De 0 a 9007199254740991

  • languageslista de texto

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