본문으로 건너뛰기

작품의 리뷰 요약 조회

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

리뷰 수와 평가 수, 평균 점수, 점수 분포, 항목별 평균, 리뷰어들이 가장 많이 언급한 장점과 단점을 반환해요.

요청

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

매개변수

  • id

    경로필수

    항목의 ID(UUID).

    텍스트

응답

요청이 성공하면 다음 JSON과 함께 200으로 응답해요.

  • reviewCount정수

    0부터 9007199254740991까지

  • ratingCount정수

    0부터 9007199254740991까지

  • averageHalfPoints숫자null일 수 있음
  • scoreBuckets정수 목록

    0부터 9007199254740991까지

  • categories객체 목록
    • category텍스트
      허용되는 값storycharactersvisualssoundenjoyment
    • averageHalfPoints숫자
    • scoreCount정수

      0부터 9007199254740991까지

  • topPraisedCategory텍스트null일 수 있음
    허용되는 값storycharactersvisualssoundenjoyment
  • themes객체 목록
    • kind텍스트
      허용되는 값procon
    • label텍스트
    • count정수

      0부터 9007199254740991까지

  • languages텍스트 목록

오류

다른 모든 작업처럼 이 작업도 매개변수가 잘못되면 400, 찾는 것이 없으면 404, 요청을 너무 많이 보내면 429로 응답할 수 있어요. 모든 오류는 같은 형식이에요.

오류 알아보기