Pular para o conteúdo

Obter o resumo das resenhas de uma obra

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

Retorna as contagens de resenhas e avaliações, a nota média, a distribuição das notas, as médias por categoria e os prós e contras mais citados pelos resenhistas.

Requisição

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

Parâmetros

  • id

    caminhoobrigatório

    ID do item, um UUID.

    texto

Resposta

Uma requisição bem-sucedida responde 200 com este JSON:

  • reviewCountnúmero inteiro

    De 0 a 9007199254740991

  • ratingCountnúmero inteiro

    De 0 a 9007199254740991

  • averageHalfPointsnúmeropode ser null
  • scoreBucketslista de número inteiro

    De 0 a 9007199254740991

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

      De 0 a 9007199254740991

  • topPraisedCategorytextopode ser null
    Valores permitidosstorycharactersvisualssoundenjoyment
  • themeslista de objeto
    • kindtexto
      Valores permitidosprocon
    • labeltexto
    • countnúmero inteiro

      De 0 a 9007199254740991

  • languageslista de texto

Erros

Como toda operação, esta pode responder 400 para parâmetros inválidos, 404 quando nada é encontrado e 429 quando você envia requisições demais. Todos os erros compartilham o mesmo formato.

Leia sobre erros