Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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

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

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

2. API Spec

1) Request

Headers > Channel

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}

Code {channel_code}

2) Path Parameter

Name

Required

Type

Description

Example

product_code

O

UUIDString

Product ID(UUID)

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

3) Response

Name

Type

Description

Example

status_code

Integer

정상 처리 시 200

prices

List

option_code

UUIDString

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

currency

String

  • 상품이 팔린 화폐

  • 원화 “KRW”

  • 미국 달러 ”USD”

price

String

  • 가격

  • 소수점 5자리

    “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: 200 Cause: 정상 처리 시
    Code Block
    languagenone
    {
      "status_code": 200,
      "prices": [
        {
          "option_code": "d96b2ed4-12c5-4fb5-ae94-4f39b11ee980"
          "currency": "KRW",
          "unit_selling_price_usd": "71200.00000"
        },
        {80.00,
           "option_code": "90c2e47c-c1e2-4d9f-8b91-1073fd929255"
          "currency": "KRW""selling_price_per_person_usd": 75.00,
          "unit_selling_price_krw": "70000.00000"
        },
        {88000.00,
          "option_code": "fb0a4845-7566-4c0b-8b68-23d822dff020"
          "currency": "KRW",
          "price": "69800.00000"selling_price_per_person_krw": 82500.00,
        }
      ]
    }

    5) Error Spec

    Expand
    titleStatus Code : 404 Cause: 유효하지 않은 요청 값
    Code Block
    {'message': '찾을 수 없습니다.'}

    ...

    3. Request Example

    1) CURL

    Code Block
    languagebash
    curl --X 'POST' location --request GET\
      'https://prod.ax-cloud.com/v1/channel/price/tour/55f2eaafe99f822f-154f42a8-45524d3f-adcd890e-d2542b4153eb77c5a9bc9cf3' \
      --Hheader 'acceptAuthorization: application/jsonToken <access_key>' \
      --Hheader 'Content-Type: application/json' \
      -H "Authorization: Token api_key_secret" \
      -H "Channel: Code code_secret" \
      -d '{
      "status_code": 200,
      "prices": [
        {
          "option_code": "d96b2ed4-12c5-4fb5-ae94-4f39b11ee980"
          "currency": "KRW",
          "price": "71200.00000"
        },
        {
          "option_code": "90c2e47c-c1e2-4d9f-8b91-1073fd929255"
          "currency": "KRW",
          "price": "70000.00000"
        },
        {
          "option_code": "fb0a4845-7566-4c0b-8b68-23d822dff020"
          "currency": "KRW",
          "price": "69800.00000"
        }
      ]
    }'