sayren Docs
리뷰

리뷰 목록 조회

GET
/v1/reviews

Authorization

accessToken
headerAuthorizationBearer <token>

Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)

Query Parameters

productId?string

상품 id 필터

rating?string

별점 필터 (일치)

Value in"1""2""3""4""5"
replied?string

답글 여부 필터. true면 답글 단 리뷰만, false면 답글 없는 리뷰만

Value in"true""false"
hasImage?string

true면 이미지가 있는 리뷰만

Value in"true""false"
from?string

작성 시각 조회 시작 (ISO 8601, 포함)

sort?string

정렬 (기본 createdAt.desc)

Value in"createdAt.desc""createdAt.asc""rating.asc""rating.desc"
page?string

페이지 번호 (1부터, 기본 1)

size?string

페이지 크기 (기본 20, 최대 100)

Header Parameters

X-Store-Id*string

대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다

Response Body

성공

application/json
  1. response
meta*
data*
error*|null
curl -X GET 'https://api.sayren.io/v1/reviews' \  -H 'X-Store-Id: string'
{  "meta": {    "status": 200,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": {    "page": 0,    "size": 0,    "totalElements": 0,    "totalPages": 0,    "contents": [      {        "reviewId": "string",        "productId": "string",        "productName": "string",        "orderItemId": "string",        "optionName": "string",        "rating": 1,        "content": "string",        "images": [          "http://example.com"        ],        "writerMaskedName": "string",        "blinded": true,        "reply": {          "content": "string",          "repliedAt": "string",          "updatedAt": "string"        },        "createdAt": "string"      }    ]  },  "error": null}