2. API spec

1) Request

Endpoint	product environment: https://prod.ax-cloud.com/v1/channel/products/tour test environment: https://test.ax-cloud.com/v1/channel/products/tour
Method	GET
Description	Product List 를 조회합니다.
Content-Type	application/json
Headers > Authorization	Token {api_key}	Headers > Channel	Code {channel_code}

2) Query Parameter

Name	Required	Type	Description
page	X	Integer	Page number(default : 1)
page_size	X	Integer	Size per page(default : 25)

3) Response

Info
아래 항목에서 value가 비어있는 경우 “Void“[String] 로 표기됩니다.

Name		Type	Description	Example
status_code		Integer	정상 처리 시 200	200 403
products		List[Object]	판매 가능한 상품 리스트
	product_code	String	상품 아이디	title	String	상품 제목식별자 (UUID)
	category	String	상품 카테고리departure_city	“Activity”	String	출발 도시	transportation	String	탈 것	booking_available_start_date	String	예약 가능한 날짜	cancellation_type	String	주문 취소 타입	main_country_and_city	String	주 국가 및 도시	country_and_city_1	String	국가 및 도시1	country_and_city_2	String	국가 및 도시2	country_and_city_3	String	국가 및 도시3	country_and_city_4	String	국가 및 도시4	country_and_city_5	String	국가 및 도시5	country_and_city_6	String	국가 및 도시6	course_1_address	String	코스 1의 주소	course_2_address	String	코스 2의 주소	course_3_address	String	코스 3의 주소	course_4_address	String	코스 4의 주소	course_5_address	String	코스 5의 주소	course_6_address	String	코스 6의 주소	course_7_address	String	코스 7의 주소	course_8_address	String	코스 8의 주소	course_9_address	String	코스 9의 주소	course_10_address	String	코스 10의 주소	selling_price	String	채널 판매 가격	selling_price_currency	String	채널 판매 통화	“Tour”
	product_listing_language	String	상품 언어	“French” “Korean”
	tour_guide_certification	String	투어 가이드의 자격증 소지 여부	“Yes” “No”
	separate_driver_included	String	투어 가이드가 운전사 역할도 하는지 여부	“Yes” “No”
	product_name	String	상품 이름	"Paris City Tour"
	departure_city	String	출발 도시 요청 - 표준 데이터	“France - Paris” “South Korea - Seoul” “United Kingdom - London”
	transportation	String	도보/차량	“Walking“ “Vehicle“
	cancellation_type	String	주문 취소 타입 Anytime cancellation: 언제든지 취소 가능 Cancellation in according to rules: 서플라이어의 규칙에 따른다. Non-refundable: 취소불가가	“Anytime cancellation” “Cancellation in according to rules” “Non-refundable”

4) Response Example

Expand

title	Status Code : 200 정상 처리 시

Code Block

language	json

{
  "status_code": 200,
  "products": [
    {
      "product_code": "1f373f00-ecb0-485a-beed-63529d61703e",
      "title": "Louvre Highlight Tour",
      "category": "Tour", 
      "departure_city": "52-18", 
      "transportation": "On Foot", 
      "booking_available_start_dateproduct_listing_language": "Booking available from tomorrowEnglisg",
       "cancellation_type": "Anytime cancellation", 
      "main_country_and_citytour_guide_certification": "52-18Yes",
       "countryseparate_anddriver_city_1included": "52-18No",
      "country_and_city_2product_name": "Void",New Bern      "country_and_city_3": "Void",City Tour"
       "country_anddeparture_city_4": "Void",United States -     "country_and_city_5": "Void",
      "country_and_city_6": "VoidNew Bern, NC", 
     "course_1_address": "Rue de Rivoli, 75001 Paris, France",
      "course_2_address": "Void",
      "course_3_address": "Void",
      "course_4_address": "Void", "transportation": "On Foot", 
      "coursecancellation_5_addresstype": "Void",
      "course_6_address": "Void",
      "course_7_address": "Void",
      "course_8_address": "Void",
      "course_9_address": "Void",
      "course_10_address": "Void"
Anytime cancellation"
    }
  ]
}

5) Error Spec

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

 curl --location --Xrequest 'GET' \
  'https://prodtest.ax-cloud.com/v1/channel/products/tour' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H-header 'Authorization: Token api<access_key_secretkey>' \
  --H 'Channel: Code code_secret'
  -d '{
  "status_code": 200,
  "products": [
    {
      "product_code": "1f373f00-ecb0-485a-beed-63529d61703e",
      "title": "Test",
      "category": "Test", 
      "departure_city": "Test", 
      "transportation": "Test", 
      "booking_available_start_date": "Test", 
      "cancellation_type": "Test", 
      "main_country_and_city": "Test", 
      "country_and_city_1": "Test",
      "country_and_city_2": "Test",
      "country_and_city_3": "Test",
      "country_and_city_4": "Test",
      "country_and_city_5": "Test",
      "country_and_city_6": "Test",
      "course_1_address": "Test",
      "course_2_address": "Test",
      "course_3_address": "Test",
      "course_4_address": "Test",
      "course_5_address": "Test",
      "course_6_address": "Test",
      "course_7_address": "Test",
      "course_8_address": "Test",
      "course_9_address": "Test",
      "course_10_address": "Test"
    }
  ]
}'data ''

...

Version	Old Version 38	New Version Current
Changes made by	김전도Flip	남기윤Joel
Saved on	Apr 03, 2023	Apr 06, 2023

Content Comparison

Versions Compared

Key

2. API spec

1) Request

2) Query Parameter

3) Response

4) Response Example

5) Error Spec

3. Request Example

1) CURL