Versions Compared

Version Old Version 1 New Version Current
Changes made by

김상효Mike (Unlicensed)

남기윤Joel (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

...

1.

...

Get Price

1) Purpose

  • 채널에 최초 상품을 등록한 이후, 채널에서 등록한 상품들 중, Supplier에 의해 상품 정보에 변경이 발생한 상품의 간략한 정보를 확인할 수 있습니다등록된 상품의 최신 가격 정보를 조회 합니다.

  • 가장 최근에 조회한 가격일 수록 최신의 가격 정보입니다.

2) Detail

...

  • 가격 정보는 자주 주기적으로 조회해야 최신의 가격을 취득할 수 있습니다.

  • 여행자가 결제할 시기에 가까울 수록 최신 가격 정보 입니다.

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

  • 변경이 발생한 상품의 상세 정보는 상품 - 상세정보 조회 에서 확인하여 채널에 반영하도록 합니다. 업데이트 이후 옵션 매핑에 변경이있었다면, 상품 - 등록 상품 변경 요청 에서 다시 옵션 정보를 매핑하도록 합니다.

2. API Spec

1) Request

Name

Required

Endpoint

product environment: https://prod.ax-cloud.com/v1/channel/price/tour/{product_code}

test environment: https:/tour/update/test.ax-cloud.com/v1/channel/price/tour/{product_code}

Method

GET

Description

업데이트된 상품정보 확인상품의 최신 가격 정보 조회

Content-Type

application/json

Headers > Authorization

Token {api_key}

Headers > Channel

Code {channel_code}

2) Query Parameter

2) Path Parameter

Name

Required

Type

Description

Example

product_code

O

String

Product ID(UUID)

  • “c1f891f7-3f22-4b2c-a4a9-e7754c20be23”

3) Response

Name

Type

Description

page

Example

X

Integer

default : 1

page_size

X

Integer

default : 25

...

status_code

Integer

정상 처리 시 200

prices

List

option_code

String

상품의 옵션에 해당하는 식별자

“c1f891f7-3f22-4b2c-a4a9-e7754c20be23“

unit_selling_price_usd

Float

유닛당 판매 가격 USD

“100.0“

selling_price_per_person_usd

Float

인당 판매 가격 USD

“100.0“

unit_selling_price_krw

Float

유닛당 판매 가격 KRW

“100.0“

selling_price_per_person_krw

Float

인당 판매 가격 KRW

“100.0“

4) Response Example

Expand
titleStatus Code: 201 Response: 업데이트된 정보가 있는 product info200 Cause: 정상 처리 시
Code Block
languagenone
{
  "datastatus_code": 200,
  "prices": [
    {
      "productoption_idcode" : <int>,
      "title": <string>"d96b2ed4-12c5-4fb5-ae94-4f39b11ee980",
      "versionunit_selling_price_usd": <int>
    },
    {80.00,
       "product_id" : <int>"selling_price_per_person_usd": 75.00,
      "titleunit_selling_price_krw": <string>88000.00,
      "versionselling_price_per_person_krw": <int>82500.00,
    },
    ...
  ]
}

...

5) Error Spec

Expand
titleStatus Code : 400 404 Cause: 유효하지 않은 요청 값
Code Block
{'detailmessage': "유효하지'찾을 않은수 query입니다없습니다.")]'}
Expand
titleStatus Code : 403 Cause: 유효하지 않은 API Key 혹은 Channel Code
Code Block
{'detail': ErrorDetail(string='이 작업을 수행할 권한(permission)이 없습니다.', code='permission_denied')}

3. Request Example

1) CURL

Code Block
languagebash
curl -X 'GET' -location --request GET\
  'https://prod.ax-cloud.com/v1/channel/productprice/tour/updatee99f822f-42a8-4d3f-890e-77c5a9bc9cf3' \
  --Hheader 'acceptAuthorization: application/jsonToken <access_key>' \
  --Hheader 'Content-Type: application/json' \
  -H 'X-CSRFTOKEN: gVNVnmaKfzEovZJFYXnxVkZsluzfXFWJDDj9lyq1WuSHuKPpBdgv1bVTiAVrgNqu' \
  -H "Authorization: Token api_key_secret" \
  -H "Channel: Code code_secret"