본문으로 건너뛰기
API docs by Redocly

브이리뷰 Admin API

브이리뷰 어드민 기능을 API로 활용할 수 있습니다.

관리자 정보

관리자 정보 조회

Authorizations:
HTTPBasic
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "username": "string",
  • "name": "string",
  • "phoneNumber": "string",
  • "email": "string",
  • "passwordChangedAt": "string"
}

관리자 정보 수정 🚧

출시 예정입니다.

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
username
string

로그인 아이디

name
string

이름

phoneNumber
string

연락처

email
string

이메일

Responses

Request samples

Content type
application/json
{
  • "username": "string",
  • "name": "string",
  • "phoneNumber": "string",
  • "email": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "username": "string",
  • "name": "string",
  • "phoneNumber": "string",
  • "email": "string",
  • "passwordChangedAt": "string"
}

비밀번호

관리자 비밀번호 변경

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
password
required
string

새 비밀번호

Responses

Request samples

Content type
application/json
{
  • "password": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "username": "string",
  • "name": "string",
  • "phoneNumber": "string",
  • "email": "string",
  • "passwordChangedAt": "string"
}

쇼핑몰 정보

쇼핑몰 정보 조회

Authorizations:
HTTPBasic
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "uuid": "string",
  • "name": "string"
}

쇼핑몰 정보 수정

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
name
string

Responses

Request samples

Content type
application/json
{
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "uuid": "string",
  • "name": "string"
}

쇼핑몰 설정

쇼핑몰 설정 조회

Authorizations:
HTTPBasic
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "isDeliveryAlimtalkEnabled": true,
  • "isThanksAlimtalkEnabled": true,
  • "isMonthlyAlimtalkEnabled": true,
  • "thanksAlimtalkDelayDays": 0,
  • "rewardName": "string",
  • "rewardUnit": "string",
  • "isAutomaticRewardEnabled": true,
  • "videoReviewRewardAmount": 0,
  • "imageReviewRewardAmount": 0,
  • "textReviewRewardAmount": 0,
  • "textReviewRewardCondition": 0,
  • "reviewAllowedDays": 0,
  • "idleTimeoutMinutes": 0,
  • "twoFactorAuthPhoneNumber": "string"
}

쇼핑몰 설정 수정

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
isDeliveryAlimtalkEnabled
boolean

배송 완료 알림톡 활성화 여부

isThanksAlimtalkEnabled
boolean

감사톡 활성화 여부

isMonthlyAlimtalkEnabled
boolean

한달톡 활성화 여부

thanksAlimtalkDelayDays
integer

배송 완료일 기준 감사톡 발송 지연 일수

rewardName
string

리워드 이름

rewardUnit
string

리워드 단위

isAutomaticRewardEnabled
boolean

리워드 자동 지급 여부

videoReviewRewardAmount
integer

비디오 리뷰 리워드 수량

imageReviewRewardAmount
integer

이미지 리뷰 리워드 수량

textReviewRewardAmount
integer

텍스트 리뷰 리워드 수량

textReviewRewardCondition
integer

텍스트 리뷰 최소 글자수 조건

reviewAllowedDays
integer

리뷰 작성 기한 일수

idleTimeoutMinutes
integer

Idle timeout 시간 (분)

twoFactorAuthPhoneNumber
string

2FA 인증 코드를 수신할 연락처 (E164 포맷)

Responses

Request samples

Content type
application/json
{
  • "isDeliveryAlimtalkEnabled": true,
  • "isThanksAlimtalkEnabled": true,
  • "isMonthlyAlimtalkEnabled": true,
  • "thanksAlimtalkDelayDays": 0,
  • "rewardName": "string",
  • "rewardUnit": "string",
  • "isAutomaticRewardEnabled": true,
  • "videoReviewRewardAmount": 0,
  • "imageReviewRewardAmount": 0,
  • "textReviewRewardAmount": 0,
  • "textReviewRewardCondition": 0,
  • "reviewAllowedDays": 0,
  • "idleTimeoutMinutes": 0,
  • "twoFactorAuthPhoneNumber": "string"
}

Response samples

Content type
application/json
{
  • "isDeliveryAlimtalkEnabled": true,
  • "isThanksAlimtalkEnabled": true,
  • "isMonthlyAlimtalkEnabled": true,
  • "thanksAlimtalkDelayDays": 0,
  • "rewardName": "string",
  • "rewardUnit": "string",
  • "isAutomaticRewardEnabled": true,
  • "videoReviewRewardAmount": 0,
  • "imageReviewRewardAmount": 0,
  • "textReviewRewardAmount": 0,
  • "textReviewRewardCondition": 0,
  • "reviewAllowedDays": 0,
  • "idleTimeoutMinutes": 0,
  • "twoFactorAuthPhoneNumber": "string"
}

상품

상품 목록 조회

Authorizations:
HTTPBasic
query Parameters
sort
string
Default: "ID"
Enum: "ID" "NAME" "REVIEW_COUNT"

정렬 필드 (ProductOrderField)

direction
string
Default: "DESC"
Enum: "ASC" "DESC"

정렬 방향 (OrderDirection)

first
integer

조회할 개수 (기본값: 30, 최대값: 100)

after
string

조회할 시작 커서 (응답의 pageInfo.endCursor)

productGroupIds
Array of strings

상품 그룹 ID 목록

isAlimtalkEnabled
boolean

알림톡 활성화 여부

originIds
Array of strings

고객사 상품 ID 목록

header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ],
  • "pageInfo": {
    }
}

상품 생성

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
originId
required
string

고객사 상품 ID

name
required
string

상품 이름

imageUrl
string

상품 이미지 URL

Array of objects

카테고리 목록 (CreateProductBodyCategory)

groupId
string

상품 그룹 ID. 존재하지 않는 ID를 입력한 경우 경우 실패합니다.

groupName
string

상품 그룹 이름. 존재하지 않는 이름을 입력한 경우 자동으로 상품 그룹을 생성합니다.

isAlimtalkEnabled
boolean
Default: true

알림톡 활성화 여부

isReviewDisabled
boolean
Default: false

리뷰 작성 불가 여부

Responses

Request samples

Content type
application/json
{
  • "originId": "string",
  • "name": "string",
  • "imageUrl": "string",
  • "categories": [
    ],
  • "groupId": "string",
  • "groupName": "string",
  • "isAlimtalkEnabled": true,
  • "isReviewDisabled": false
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "name": "string",
  • "image": {
    },
  • "url": "string",
  • "categories": [
    ],
  • "group": {
    },
  • "brand": {
    },
  • "isAlimtalkEnabled": "string",
  • "reviewCount": 0,
  • "reviewRatingAverage": 0,
  • "isReviewDisabled": true
}

상품 조회

Authorizations:
HTTPBasic
path Parameters
productId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "name": "string",
  • "image": {
    },
  • "url": "string",
  • "categories": [
    ],
  • "group": {
    },
  • "brand": {
    },
  • "isAlimtalkEnabled": "string",
  • "reviewCount": 0,
  • "reviewRatingAverage": 0,
  • "isReviewDisabled": true
}

상품 수정

Authorizations:
HTTPBasic
path Parameters
productId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
name
string

상품 이름

imageUrl
string

상품 이미지 URL

Array of objects

카테고리 목록 (CreateProductBodyCategory)

groupId
string

상품 그룹 ID

isAlimtalkEnabled
boolean
Default: true

알림톡 활성화 여부

isReviewDisabled
boolean
Default: false

리뷰 작성 불가 여부

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "imageUrl": "string",
  • "categories": [
    ],
  • "groupId": "string",
  • "isAlimtalkEnabled": true,
  • "isReviewDisabled": false
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "name": "string",
  • "image": {
    },
  • "url": "string",
  • "categories": [
    ],
  • "group": {
    },
  • "brand": {
    },
  • "isAlimtalkEnabled": "string",
  • "reviewCount": 0,
  • "reviewRatingAverage": 0,
  • "isReviewDisabled": true
}

상품 일괄 생성

상품을 일괄 생성합니다. 한 번에 최대 100개까지 요청할 수 있습니다. 요청한 즉시 비동기 작업이 생성되며, 비동기 작업 상태를 조회할 수 있는 jobId가 요청한 데이터 순서대로 반환됩니다. 이 값을 일괄 생성 작업 조회 API에 사용해서 작업 상태를 조회할 수 있습니다.

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
Array
originId
required
string

고객사 상품 ID

name
required
string

상품 이름

imageUrl
string

상품 이미지 URL

Array of objects

카테고리 목록 (CreateProductBodyCategory)

groupId
string

상품 그룹 ID. 존재하지 않는 ID를 입력한 경우 경우 실패합니다.

groupName
string

상품 그룹 이름. 존재하지 않는 이름을 입력한 경우 자동으로 상품 그룹을 생성합니다.

isAlimtalkEnabled
boolean
Default: true

알림톡 활성화 여부

isReviewDisabled
boolean
Default: false

리뷰 작성 불가 여부

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

상품 그룹

상품 그룹 목록 조회

Authorizations:
HTTPBasic
query Parameters
ordering
string
Default: "-created_at"
Enum: "name" "review_count" "created_at" "-created_at"

정렬 방식 (ProductGroupOrdering)

first
integer

조회할 개수 (기본값: 30, 최대값: 100)

after
string

조회할 시작 커서 (응답의 pageInfo.endCursor)

name
string

상품 그룹 이름

header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ],
  • "pageInfo": {
    }
}

상품 그룹 조회

Authorizations:
HTTPBasic
path Parameters
productGroupId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "image": {
    },
  • "productCount": 0,
  • "reviewCount": 0,
  • "reviewRatingAverage": 0,
  • "createdAt": "string",
  • "updatedAt": "string"
}

상품 그룹 삭제

Authorizations:
HTTPBasic
path Parameters
productGroupId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

상품 그룹 수정

Authorizations:
HTTPBasic
path Parameters
productGroupId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
name
string

상품 그룹 이름

Responses

Request samples

Content type
application/json
{
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "image": {
    },
  • "productCount": 0,
  • "reviewCount": 0,
  • "reviewRatingAverage": 0,
  • "createdAt": "string",
  • "updatedAt": "string"
}

상품 그룹 생성

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
name
required
string

상품 그룹 이름

Responses

Request samples

Content type
application/json
{
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "image": {
    },
  • "productCount": 0,
  • "reviewCount": 0,
  • "reviewRatingAverage": 0,
  • "createdAt": "string",
  • "updatedAt": "string"
}

상품 그룹에 상품 추가

Authorizations:
HTTPBasic
path Parameters
productGroupId
required
string
productId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "name": "string",
  • "image": {
    },
  • "productCount": 0,
  • "reviewCount": 0,
  • "reviewRatingAverage": 0,
  • "createdAt": "string",
  • "updatedAt": "string"
}

상품 그룹에서 상품 제거

Authorizations:
HTTPBasic
path Parameters
productGroupId
required
string
productId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

카테고리

카테고리 목록 조회

Authorizations:
HTTPBasic
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ],
  • "pageInfo": {
    }
}

카테고리 생성

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
originId
required
string

고객사 카테고리 ID

name
required
string

카테고리 이름

isVisible
boolean
Default: true

카테고리 노출 여부

position
integer
Default: 0

카테고리 노출 순서

parentOriginId
string

부모 카테고리 고유 ID

isReviewDisabled
boolean
Default: false

리뷰 작성 불가 여부

Responses

Request samples

Content type
application/json
{
  • "originId": "string",
  • "name": "string",
  • "isVisible": true,
  • "position": 0,
  • "parentOriginId": "string",
  • "isReviewDisabled": false
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "name": "string",
  • "isVisible": true,
  • "isReviewDisabled": true
}

카테고리 조회

Authorizations:
HTTPBasic
path Parameters
categoryId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "name": "string",
  • "isVisible": true,
  • "isReviewDisabled": true
}

카테고리 삭제

Authorizations:
HTTPBasic
path Parameters
categoryId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
null

카테고리 수정

Authorizations:
HTTPBasic
path Parameters
categoryId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
name
string

카테고리 이름

isVisible
boolean
Default: true

카테고리 노출 여부

position
integer

카테고리 노출 순서

parentOriginId
string

부모 카테고리 고유 ID

isReviewDisabled
boolean
Default: false

리뷰 작성 불가 여부

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "isVisible": true,
  • "position": 0,
  • "parentOriginId": "string",
  • "isReviewDisabled": false
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "name": "string",
  • "isVisible": true,
  • "isReviewDisabled": true
}

카테고리 일괄 생성

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
Array
originId
required
string

고객사 카테고리 ID

name
required
string

카테고리 이름

isVisible
boolean
Default: true

카테고리 노출 여부

position
integer
Default: 0

카테고리 노출 순서

parentOriginId
string

부모 카테고리 고유 ID

isReviewDisabled
boolean
Default: false

리뷰 작성 불가 여부

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

주문

주문 생성

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
originId
required
string

고객사 주문 ID

memberOriginId
string

고객사 회원 ID

orderedAt
required
string <date-time>

주문 일시

object

주문 구매자 정보 (OrderBuyerInput)

object

주문 수령인 정보 (OrderRecipientInput)

alimtalkTemplateCode
string

챗봇 템플릿 코드 - 브이리뷰 팀에서 안내받은 템플릿이 없다면 null을 입력해주세요.

required
Array of objects

주문 아이템 목록 (CreateOrderBodyOrderItem)

Responses

Request samples

Content type
application/json
{
  • "originId": "string",
  • "memberOriginId": "string",
  • "orderedAt": "2019-08-24T14:15:22Z",
  • "buyer": {
    },
  • "recipient": {
    },
  • "alimtalkTemplateCode": "string",
  • "items": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "orderedAt": "string",
  • "memberOriginId": "string",
  • "alimtalkTemplateCode": "string",
  • "buyer": {
    },
  • "recipient": {
    },
  • "items": [
    ]
}

주문 조회

Authorizations:
HTTPBasic
path Parameters
orderId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "orderedAt": "string",
  • "memberOriginId": "string",
  • "alimtalkTemplateCode": "string",
  • "buyer": {
    },
  • "recipient": {
    },
  • "items": [
    ]
}

주문 수정

Authorizations:
HTTPBasic
path Parameters
orderId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
memberOriginId
string

고객사 회원 ID

orderedAt
string <date-time>

주문 일시

object

주문 구매자 정보 (OrderBuyerInput)

object

주문 수령인 정보 (OrderRecipientInput)

alimtalkTemplateCode
string

챗봇 템플릿 코드 - 브이리뷰 팀에서 안내받은 템플릿이 없다면 null을 입력해주세요.

Array of objects

주문 아이템 목록 (CreateOrderBodyOrderItem)

Responses

Request samples

Content type
application/json
{
  • "memberOriginId": "string",
  • "orderedAt": "2019-08-24T14:15:22Z",
  • "buyer": {
    },
  • "recipient": {
    },
  • "alimtalkTemplateCode": "string",
  • "items": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "orderedAt": "string",
  • "memberOriginId": "string",
  • "alimtalkTemplateCode": "string",
  • "buyer": {
    },
  • "recipient": {
    },
  • "items": [
    ]
}

주문 일괄 생성

주문을 일괄 생성합니다. 한 번에 최대 100개까지 요청할 수 있습니다. 요청한 즉시 비동기 작업이 생성되며, 비동기 작업 상태를 조회할 수 있는 jobId가 요청한 데이터 순서대로 반환됩니다. 이 값을 일괄 생성 작업 조회 API에 사용해서 작업 상태를 조회할 수 있습니다.

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
Array
originId
required
string

고객사 주문 ID

memberOriginId
string

고객사 회원 ID

orderedAt
required
string <date-time>

주문 일시

object

주문 구매자 정보 (OrderBuyerInput)

object

주문 수령인 정보 (OrderRecipientInput)

alimtalkTemplateCode
string

챗봇 템플릿 코드 - 브이리뷰 팀에서 안내받은 템플릿이 없다면 null을 입력해주세요.

required
Array of objects

주문 아이템 목록 (CreateOrderBodyOrderItem)

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

주문 아이템

주문 아이템 조회

Authorizations:
HTTPBasic
path Parameters
orderItemId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "status": "DELIVERED",
  • "product": {
    },
  • "selectedOptions": [
    ],
  • "shipment": {
    }
}

주문 아이템 수정

Authorizations:
HTTPBasic
path Parameters
orderItemId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
productOriginId
required
string

고객사 상품 ID

status
string
Enum: "DELIVERED" "RETURN" "CANCEL" "FAIL" "EXCHANGE"

주문 아이템 상태 (OrderItemStatus)

Array of objects

주문한 옵션 목록 (SelectedOptionInput)

object

배송 정보 (CreateShipmentBody)

Responses

Request samples

Content type
application/json
{
  • "productOriginId": "string",
  • "status": "DELIVERED",
  • "selectedOptions": [
    ],
  • "shipment": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "status": "DELIVERED",
  • "product": {
    },
  • "selectedOptions": [
    ],
  • "shipment": {
    }
}

주문별 주문 아이템 조회

Authorizations:
HTTPBasic
path Parameters
orderId
required
string
orderItemId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "status": "DELIVERED",
  • "product": {
    },
  • "selectedOptions": [
    ],
  • "shipment": {
    }
}

주문 아이템 추가

Authorizations:
HTTPBasic
path Parameters
orderId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
originId
required
string

고객사 주문 아이템 ID

productOriginId
required
string

고객사 상품 ID

status
string
Enum: "DELIVERED" "RETURN" "CANCEL" "FAIL" "EXCHANGE"

주문 아이템 상태 (OrderItemStatus)

Array of objects

주문한 옵션 목록 (SelectedOptionInput)

object

배송 정보 (CreateShipmentBody)

Responses

Request samples

Content type
application/json
{
  • "originId": "string",
  • "productOriginId": "string",
  • "status": "DELIVERED",
  • "selectedOptions": [
    ],
  • "shipment": {
    }
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "orderedAt": "string",
  • "memberOriginId": "string",
  • "alimtalkTemplateCode": "string",
  • "buyer": {
    },
  • "recipient": {
    },
  • "items": [
    ]
}

주문 아이템 일괄 생성

주문 아이템을 일괄 생성합니다. 한 번에 최대 100개까지 요청할 수 있습니다. 요청한 즉시 비동기 작업이 생성되며, 비동기 작업 상태를 조회할 수 있는 jobId가 요청한 데이터 순서대로 반환됩니다. 이 값을 일괄 생성 작업 조회 API에 사용해서 작업 상태를 조회할 수 있습니다.

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
Array
orderOriginId
required
string

고객사 주문 ID

originId
required
string

고객사 주문 아이템 ID

productOriginId
required
string

고객사 상품 ID

status
string
Enum: "DELIVERED" "RETURN" "CANCEL" "FAIL" "EXCHANGE"

주문 아이템 상태 (OrderItemStatus)

Array of objects

주문한 옵션 목록 (SelectedOptionInput)

object

배송 정보 (CreateShipmentBody)

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

리뷰

리뷰 목록 조회

Authorizations:
HTTPBasic
query Parameters
sort
string
Default: "CREATED_AT"
Enum: "REVIEW_TYPE" "HELPFUL_COUNT" "CREATED_AT" "EDITED_AT" "UPDATED_AT"

정렬 필드 (ReviewOrderField)

direction
string
Default: "DESC"
Enum: "ASC" "DESC"

정렬 방향 (OrderDirection)

first
integer

조회할 개수 (기본값: 30, 최대값: 100)

after
string

조회할 시작 커서 (응답의 pageInfo.endCursor)

contentTypes
Array of strings
Items Enum: "VIDEO" "IMAGE" "TEXT"

콘텐츠 타입 (ReviewContentType)

ratings
Array of integers

평점

text
string

리뷰 내용

productOriginIds
Array of strings

상품 ID 목록

productName
string

상품 이름

orderOriginIds
Array of strings

주문 번호 목록

orderMemberOriginId
string

리뷰 작성자 ID

orderName
string

상품 구매자 또는 수령인 이름

orderPhone
string

상품 구매자 또는 수령인 연락처 (exact 검색)

isVisible
boolean

리뷰 노출 여부

isBlocked
boolean

리뷰 노출 제한 여부

isFixed
boolean

고정 리뷰 여부

isRewarded
boolean

적립금 지급 여부

isCommented
boolean

관리자 댓글 존재 여부

isReported
boolean

신고 여부

uploadFroms
Array of strings
Items Enum: "CHATBOT" "WEB" "INGEST" "SPRAY" "ADMIN" "DEMO"

리뷰 작성 경로 (ReviewUploadFrom)

createdAtStart
string

리뷰 작성일 시작 일시 (ISO-8601)

createdAtEnd
string

리뷰 작성일 종료 일시 (ISO-8601)

editedAtStart
string

리뷰 작성일 시작 일시 (ISO-8601)

editedAtEnd
string

리뷰 작성일 종료 일시 (ISO-8601)

updatedAtStart
string

리뷰 작성일 시작 일시 (ISO-8601)

updatedAtEnd
string

리뷰 작성일 종료 일시 (ISO-8601)

header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ],
  • "pageInfo": {
    }
}

리뷰 조회

Authorizations:
HTTPBasic
path Parameters
reviewId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "userNickname": "string",
  • "title": "string",
  • "text": "string",
  • "rating": 0,
  • "uploadFrom": "CHATBOT",
  • "videos": [
    ],
  • "images": [
    ],
  • "product": {
    },
  • "order": {
    },
  • "orderItem": {
    },
  • "questionAnswers": [
    ],
  • "isVisible": true,
  • "isBlocked": true,
  • "blockReason": "DUPLICATE_VIDEO",
  • "helpfulCount": 0,
  • "reportStatus": "PENDING",
  • "createdAt": "string",
  • "updatedAt": "string"
}

리뷰 정보 수정

Authorizations:
HTTPBasic
path Parameters
reviewId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
isVisible
boolean

리뷰 노출 여부

Responses

Request samples

Content type
application/json
{
  • "isVisible": true
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "originId": "string",
  • "userNickname": "string",
  • "title": "string",
  • "text": "string",
  • "rating": 0,
  • "uploadFrom": "CHATBOT",
  • "videos": [
    ],
  • "images": [
    ],
  • "product": {
    },
  • "order": {
    },
  • "orderItem": {
    },
  • "questionAnswers": [
    ],
  • "isVisible": true,
  • "isBlocked": true,
  • "blockReason": "DUPLICATE_VIDEO",
  • "helpfulCount": 0,
  • "reportStatus": "PENDING",
  • "createdAt": "string",
  • "updatedAt": "string"
}

리뷰 일괄 생성

리뷰를 일괄 생성합니다. 한 번에 최대 100개까지 요청할 수 있습니다. 요청한 즉시 비동기 작업이 생성되며, 비동기 작업 상태를 조회할 수 있는 jobId가 요청한 데이터 순서대로 반환됩니다. 이 값을 일괄 생성 작업 조회 API에 사용해서 작업 상태를 조회할 수 있습니다.

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
Array
originId
required
string

고객사 리뷰 ID

productOriginId
required
string

고객사 상품 ID

authorName
string <= 255 characters

작성자 이름

title
string <= 255 characters

리뷰 제목

videoUrls
Array of strings

리뷰 비디오 URL 목록

imageUrls
Array of strings

리뷰 이미지 URL 목록

text
string

리뷰 본문

rating
integer

리뷰 평점 (1-5)

Array of objects

질문 답변 목록 (CreateReviewBodyQuestionAnswer)

orderOriginId
string

고객사 주문 ID

orderItemOriginId
string

고객사 주문 아이템 ID

createdAt
string <date-time>

리뷰 생성 일시

isVisible
boolean
Default: true

리뷰 노출 여부

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

고정 리뷰

상품별 고정 리뷰 조회

Authorizations:
HTTPBasic
path Parameters
productId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
[
  • {
    }
]

상품별 고정 리뷰 설정

Authorizations:
HTTPBasic
path Parameters
productId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
ids
required
Array of strings

고정할 리뷰 ID 목록

Responses

Request samples

Content type
application/json
{
  • "ids": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

상품 그룹별 고정 리뷰 설정

Authorizations:
HTTPBasic
path Parameters
productGroupId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
ids
required
Array of strings

고정할 리뷰 ID 목록

Responses

Request samples

Content type
application/json
{
  • "ids": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

베스트 리뷰

베스트 리뷰 목록 조회

Authorizations:
HTTPBasic
query Parameters
first
integer

조회할 개수 (기본값: 30, 최대값: 100)

after
string

조회할 시작 커서 (응답의 pageInfo.endCursor)

header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ],
  • "pageInfo": {
    }
}

베스트 리뷰 설정

Authorizations:
HTTPBasic
header Parameters
authorization
required
string
Request Body schema: application/json
required
reviewIds
required
Array of strings

리뷰 ID 목록

Responses

Request samples

Content type
application/json
{
  • "reviewIds": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

리뷰 신고

전체 리뷰 신고 목록 조회

Authorizations:
HTTPBasic
query Parameters
first
integer

조회할 개수 (기본값: 30, 최대값: 100)

after
string

조회할 시작 커서 (응답의 pageInfo.endCursor)

reasons
Array of strings
Items Enum: "ILLEGAL" "PERSONAL_INFO" "SPAM" "IRRELEVANT" "MISLEADING" "INAPPROPRIATE" "DUPLICATED" "ETC"

신고 사유 (ReviewReportReason)

isChecked
boolean

신고 처리 여부

createdAtStart
string

리뷰 신고 생성일시 시작 (ISO-8601)

createdAtEnd
string

리뷰 신고 생성일시 종료 (ISO-8601)

updatedAtStart
string

리뷰 신고 수정일시 시작 (ISO-8601)

updatedAtEnd
string

리뷰 신고 수정일시 종료 (ISO-8601)

header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ],
  • "pageInfo": {
    }
}

리뷰 신고 수정

Authorizations:
HTTPBasic
path Parameters
reviewReportId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
isChecked
boolean

신고 처리 여부

Responses

Request samples

Content type
application/json
{
  • "isChecked": true
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "reason": "ILLEGAL",
  • "text": "string",
  • "isChecked": true,
  • "review": {
    },
  • "createdAt": "string",
  • "updatedAt": "string"
}

개별 리뷰 신고 목록 조회

Authorizations:
HTTPBasic
path Parameters
reviewId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ],
  • "pageInfo": {
    }
}

관리자 댓글

관리자 댓글 목록 조회

Authorizations:
HTTPBasic
path Parameters
reviewId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ],
  • "pageInfo": {
    }
}

관리자 댓글 생성

Authorizations:
HTTPBasic
path Parameters
reviewId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
text
required
string

댓글 내용

Responses

Request samples

Content type
application/json
{
  • "text": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "text": "string",
  • "createdAt": "string",
  • "updatedAt": "string"
}

관리자 댓글 삭제

Authorizations:
HTTPBasic
path Parameters
commentId
required
string
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "detail": [
    ]
}

관리자 댓글 수정

Authorizations:
HTTPBasic
path Parameters
commentId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
text
string

댓글 내용

Responses

Request samples

Content type
application/json
{
  • "text": "string"
}

Response samples

Content type
application/json
{
  • "id": "string",
  • "text": "string",
  • "createdAt": "string",
  • "updatedAt": "string"
}

관리자 댓글 일괄 생성 🚧

출시 예정입니다.

Authorizations:
HTTPBasic
path Parameters
reviewId
required
string
header Parameters
authorization
required
string
Request Body schema: application/json
required
Array
text
required
string

댓글 내용

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

Content type
application/json
[
  • {
    }
]

질문

질문 목록 조회

Authorizations:
HTTPBasic
query Parameters
first
integer

조회할 개수 (기본값: 30, 최대값: 100)

after
string

조회할 시작 커서 (응답의 pageInfo.endCursor)

type
string
Enum: "statistical" "userinfo"
header Parameters
authorization
required
string

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "data": [
    ],
  • "pageInfo": {
    }
}

질문 조회

Authorizations:
HTTPBasic
path Parameters
questionId
required
string
header Parameters
authorization
required
string

Responses

Response samples