샌드박스 환경에서 주문과 배송 상태를 변경해 볼 수 있는 API입니다. 이 API를 활용하여 주문을 취소하거나 강제로 종료하는 등의 상태 변경을 테스트할 수 있습니다. 다양한 시나리오에 맞게 주문 상태를 변경해보면서 원하는 동작을 확인해보세요.
<aside> 💡 * 해당 API는 샌드박스 환경에서만 사용할 수 있습니다.
</aside>
요청 호출 방식과 각 요청 헤더에 포함될 내용에 안내합니다. 요청이 실패할 경우 문제 해결하기에서 에러에 대한 상세 내용을 확인하세요.
표 1 | 호출 방식
Method | URL |
---|---|
PATCH |
https://open-order.sandbox.onkakao.net/goa-open-service/api/v1/developers/orders/{orderId}/status |
표 2 | 요청 헤더
Parameter | Description |
---|---|
Authorization | 시작하기에서 생성한 Authorization 파라미터값 |
vendor | 발급받은 API 키 |
Content-Type | application/json |
curl -X 'PATCH' \\
'<https://open-order.sandbox.onkakao.net/goa-open-service/api/v1/developers/orders/b9f545df-1156-4ddb-a56a-81140a464dba/status>' \\
-H 'accept: application/json' \\
-H 'vendor: VZQZ2P' \\
-H 'Content-Type: application/json' \\
-d '{
"orderStatus": "CANCEL",
"cancelBy": "ADMIN"
}'
요청에 대한 파라미터는 다음과 같습니다.
표 3 | 요청 파라미터
Name | Type | Description | Required |
---|---|---|---|
orderId |
String |
주문 아이디 | 필수 |
orderStatus |
String |
변경하려는 주문의 상태 | 필수 |
cancelBy |
String |
주문 취소 주체 | 선택 |