Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 7 Next »

1. Create Review

1) Purpose

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

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

2) Detail

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

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

2. API spec

1) Request

Endpoint

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


test 환경: https://test.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

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

status_code

Integer

  • 정상 처리 시 201

 Status Code : 201 Response: AX Cloud 에 생성된 리뷰
{
  "status_code": 201
}

4) Error Spec

 Status Code : 400 Cause: 유효하지 않은 요청 값
{'body': '이 필드는 null일 수 없습니다.'}
 Status Code : 403 Cause: 유효하지 않은 API Key 혹은 Channel Code
{'message': '이 작업을 수행할 권한(permission)이 없습니다.'}

3. Request Example

1) CURL

  • curl -X 'POST' \
  'https://prod.ax-cloud.com/v1/channel/review/day-ticket' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Token api_key_secret" \
  -H "Channel: Code code_secret" \
  -d '{
      "channel_order_code": "090a9be0397",
      "review_score_type": "ONE_FIVE",
      "review_score": 100,
      "title": "즐거운 경험이었습니다.",
      "body": "친절한 가이드분 덕분에 즐거웠습니다.",
      "reviewed_at": "2022-01-21T10:00:00.000Z",
      "reviewer_info": {
        "name": "홍길동",
        "phone": "01012341234",
        "email": "ABC@abc.com"
      }
}'

  • No labels