샌드박스 환경에서 주문과 배송 상태를 변경해 볼 수 있는 API입니다. 이 API를 활용하여 주문을 취소하거나 강제로 종료하는 등의 상태 변경을 테스트할 수 있습니다. 다양한 시나리오에 맞게 주문 상태를 변경해보면서 원하는 동작을 확인해보세요.

<aside> 💡 * 해당 API는 샌드박스 환경에서만 사용할 수 있습니다.

</aside>


Request

요청 호출 방식과 각 요청 헤더에 포함될 내용에 안내합니다. 요청이 실패할 경우 문제 해결하기에서 에러에 대한 상세 내용을 확인하세요.

호출 방식

표 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 주문 취소 주체 선택