Table of Contents

1. Get Price

1) Purpose

채널에 등록된 상품의 최신 가격 정보를 조회 합니다.
가장 최근에 조회한 가격일 수록 최신의 가격 정보입니다.

2) Detail

가격 정보는 자주 주기적으로 조회해야 최신의 가격을 취득할 수 있습니다.
여행자가 결제할 시기에 가까울 수록 최신 가격 정보 입니다.
고유한 채널 코드와 유효한 API Key 를 Request Header에 정해진 형식으로 입력해야만 호출 가능합니다.

2. API Spec

1) Request

...

구현 예정

Endpoint		product environment: https://prod.ax-cloud.com/v1/channel/price/tour/{product_code} test environment: https://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

구현 예정

3) Response

구현 예정

4) Error Spec

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	Example
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

title	Status Code: 200 Cause: 정상 처리 시

Code Block

language	none

{
  "status_code": 200,
  "prices": [
    {
      "option_code": "d96b2ed4-12c5-4fb5-ae94-4f39b11ee980",
      "unit_selling_price_usd": 80.00,
      "selling_price_per_person_usd": 75.00,
      "unit_selling_price_krw": 88000.00,
      "selling_price_per_person_krw": 82500.00,
    }
  ]
}

5) Error Spec

Expand

title	Status Code : 404 Cause: 유효하지 않은 요청 값

Code Block
{'message': '찾을 수 없습니다.'}

Expand

title	Status Code : 403 Cause: 유효하지 않은 API Key 혹은 Channel Code

Code Block
{'detail': ErrorDetail(string='이 작업을 수행할 권한(permission)이 없습니다.', code='permission_denied')}

3. Request Example

1) CURL

...

Code Block

language	bash

curl --location --request GET\
 'https://prod.ax-cloud.com/v1/channel/price/tour/e99f822f-42a8-4d3f-890e-77c5a9bc9cf3' \
--header 'Authorization: Token <access_key>' \
--header 'Content-Type: application/json' \

Version	Old Version 3	New Version Current
Changes made by	김상효Mike (Unlicensed)	남기윤Joel (Unlicensed)
Saved on	Mar 22, 2023	Apr 07, 2023

Versions Compared

Key

1. Get Price

1) Purpose

2) Detail

2. API Spec

1) Request

2) Query Parameter

3) Response

4) Error Spec

2) Path Parameter

3) Response

4) Response Example

5) Error Spec

3. Request Example

1) CURL

Code Block
language bash
curl --location --request GET\ 'https://prod.ax-cloud.com/v1/channel/price/tour/e99f822f-42a8-4d3f-890e-77c5a9bc9cf3' \ --header 'Authorization: Token <access_key>' \ --header 'Content-Type: application/json' \

Content Comparison

Versions Compared

Key

1. Get Price

1) Purpose

2) Detail

2. API Spec

1) Request

2) Query Parameter

3) Response

4) Error Spec

2) Path Parameter

3) Response

4) Response Example

5) Error Spec

3. Request Example

1) CURL

Code Blocklanguagebashcurl --location --request GET\ 'https://prod.ax-cloud.com/v1/channel/price/tour/e99f822f-42a8-4d3f-890e-77c5a9bc9cf3' \ --header 'Authorization: Token <access_key>' \ --header 'Content-Type: application/json' \

Code Block
language bash
curl --location --request GET\ 'https://prod.ax-cloud.com/v1/channel/price/tour/e99f822f-42a8-4d3f-890e-77c5a9bc9cf3' \ --header 'Authorization: Token <access_key>' \ --header 'Content-Type: application/json' \