1. Cancel Ticket

1) Purpose

티켓은 주문의 일부분 입니다. 티켓의 취소는 주문의 부분 취소를 의미 합니다.
티켓을 취소하면 주문의 부분 취소를 할 수 있습니다.

2) Detail

고유한 채널 코드와 유효한 API Key 를 Request Header에 정해진 형식으로 입력해야만 호출 가능합니다.
티켓 별로 여행자의 사정에 의해 주문 전체적이 아닌, 주문 부분적으로 취소가 있을 수 있습니다.

2. API Spec

1) Request

Endpoint	https://prod.ax-cloud.com/v1/channel/orders/tour/{order_code}/tickets/{ticket_code}
Method	PATCH
Description	티켓 상태 변경
Content-Type	application/json
Headers > Authorization	Token {api_key}
Headers > Channel	Code {channel_code}

2) Body Parameter

Name	Required	Type	Description
status	O	String	AX 내부 주문 상태 변경하고자 하는 티켓 상태를 입력 티켓의 상태는 다음과 같습니다. {“1": "New"}, # 새 티켓 {"3": "Traveler Canceled"}, # 여행자 취소

3) Response

Name		Type	Description
status_code		Integer	정상 처리 시 200
data		Object	-
	ticket_code	Integer	갱신된 티켓의 식별자
	ax_status	String	갱신된 티켓의 상태

Status Code : 200 Response: 변경 완료된 값

{
  "ticket_code": 915c1218-f41c-492b-bb0b-96177ff4d2ee,
  "status": "2",
}

4) Error Spec

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

{'message': '이 작업을 수행할 권한(permission)이 없습니다.'}

Status Code : 404 Cause: 유효하지 않은 order_code, ticket_code

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

3. Request Example

1) CURL

curl -X 'PATCH' \
  'https://prod.ax-cloud.com/v1/channel/orders/tour/123123/tickets/1231231' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'X-CSRFTOKEN: gVNVnmaKfzEovZJFYXnxVkZsluzfXFWJDDj9lyq1WuSHuKPpBdgv1bVTiAVrgNqu' \
  -d '{ \
  "ticket_code": 915c1218-f41c-492b-bb0b-96177ff4d2ee,
  "status": "1"
}'

copy-주문 - 주문 부분 취소 요청

1. Cancel Ticket

1) Purpose

2) Detail

2. API Spec

1) Request

2) Body Parameter

3) Response

4) Error Spec

3. Request Example

1) CURL