Versions Compared

Version Old Version 5 New Version Current
Changes made by

남기윤Joel

김상효Mike (Unlicensed)

Saved on

Key

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

...

2. API Spec

1) Request

Endpoint

product environment: https://prod.ax-cloud.com/v1/channel/price/day-ticket/{product_idcode}

Method

GET

Description

상품의 최신 가격 정보 조회

Content-Type

application/json

Headers > Authorization

Token {api_key}

Headers > Channel

Code {channel_code}

...

Name

Required

Type

Description

product_idcode

O

StringUUID

Product ID(UUID)

3) Response

Name

 

 

Type

Description

status_code

Integer

정상 처리 시 200

prices

Object

List

 

 

{

option_

name}

code

Object

UUID

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

 

 

 

 

currency

String

  • 상품이 팔린 화폐

  • {"1": "KRW"}, # 원화
    {"2": "USD"} # 미국 달러

    • 원화 “KRW”

    • 미국 달러 ”USD”

    price

    String

    • 가격

    • 소수점 5자리

    4) Response Example

    Expand
    titleStatus Code: 200 Cause: 정상 처리 시
    Code Block
    languagenone
    {
  "status_code": 200,
  "prices": [
    {
      "option_code": "d96b2ed4-12c5-4fb5-ae94-4f39b11ee980": {
      "currency": "1KRW",
      "price": "1234567871200.00000"
    },
    {
      "option_code": "90c2e47c-c1e2-4d9f-8b91-1073fd929255":
{       "currency": "1KRW",
      "price": "12345678970000.00000"
    },
    {
      "option_code": "fb0a4845-7566-4c0b-8b68-23d822dff020": {
      "currency": "1KRW",
      "price": "12345678069800.00000"
    }
  }]
}

    5) Error Spec

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

    ...

    Code Block
    curl -X 'POST' \
  'https://prod.ax-cloud.com/v1/channel/price/day-ticket/1481d654b-967f-47fb-8989-e20a9ba8477a' \
  -H 'accept: application/json' \
  -H '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": "1KRW",
      "price": "1234567871200.00000"
    },
    {
      "option_code": "90c2e47c-c1e2-4d9f-8b91-1073fd929255":
{       "currency": "1KRW",
      "price": "12345678970000.00000"
    },
    {
      "option_code": "fb0a4845-7566-4c0b-8b68-23d822dff020":
{       "currency": "1KRW",
      "price": "12345678069800.00000"
    }
  }]
}'