/
리뷰 - 날짜지정형 입장권 리뷰 생성

리뷰 - 날짜지정형 입장권 리뷰 생성


1. Create Review

1) Purpose

  • 채널에서 특정 상품에 대한 생성된 리뷰를 AX Cloud 에 등록 합니다.

  • 리뷰를 AX Cloud 에서 관리할 수 있습니다.

2) Detail

  • 상품 별로 리뷰를 등록할 수 있습니다.

  • 유효한 API Key를 Request Header에 토큰으로 입력해야만 호출 가능합니다.

2. API spec

1) Request

Endpoint

product environment: https://prod.ax-cloud.com/v1/channel/review/day-ticket/<product_id>

Method

POST

Description

채널의 리뷰 정보를 생성 합니다.

Content-Type

application/json

Headers > Authorization

Token {api_key}

Headers > Channel

Code {channel_code}

2) Body Parameter

Name

Required

Type

Description

Name

Required

Type

Description

channel_order_code

X

String

  • 주문생성시 채널이 생성한 주문의 식별자입니다.

  • 어떤 주문에 대한 리뷰인지 추적을 위한 값입니다. 공급사 편의를 위해 가능하다면 함께 전달하는것을 권장합니다.

review_score_type

O

Choice from

{

ONE_FIVE_STAR, ZERO_FIVE_STAR,GOOD_OR_BAD, NO_SCORE

}

  • ONE_FIVE

    • 1~5개의 별점등의 평가지표 사용시

  • ZERO_FIVE

    • 0~5개의 별점등의 평가지표 사용시

  • GOOD_OR_BAD

    • 좋음/싫음, 긍정/부정 등의 흑백 평가지표 사용시

  • NO_SCORE

    • 평가지표 없을시

review_score

X

Integer

  • 평가지표가 “NO_SCORE”가 아니라면 필수

  • 여행자의 점수를 0점이 최저점, 100점 만점 기준으로 환산한 점수

  • 최저점~최고점 사이의 점수로 환산

  • 소수점 첫째자리에서 반올림한 정수

  • ex) 별점 0점이 최저점, 5점이 만점인 채널에서 5점 → 100

  • ex) 별점 0점이 최저점, 5점 만점인 채널에서 4.2점 → 84

  • ex) 별점 1점이 최저점, 5점 만점인 채널에서 3점 → 50

  • ex) 별점 1점이 최저점, 5점 만점인 채널에서 4.5점 → 87.5 → 88

  • 좋음/싫음, 긍정/부정 등의 흑백 평가지표 사용시 0, 100

title

X

String

  • 리뷰 제목

body

O

String

  • 리뷰 본문. 제목은 없고 본문만 존재할 경우 본문만 전송

reviewed_at

O

DateTime

YYYY-MM-DD hh:mm

  • 리뷰 작성시간 (채널 기준)

reviewer_info

X

Object

  • 리뷰 작성자 정보 (주문 정보가 없는 경우 필요)

 

name

X

String

  • 리뷰 작성자 이름

 

phone

X

String

  • 리뷰 작성자 전화

 

email

X

String

  • 리뷰 작성자 이메일

3) Response

Name

Type

Description

Name

Type

Description

status_code

Integer

  • 정상 처리 시 201

{ "status_code": 201 }

4) Error Spec

 

{'body': '이 필드는 null일 수 없습니다.'}
{'message': '이 작업을 수행할 권한(permission)이 없습니다.'}

3. Request Example

1) CURL

  •