주문 조회하기
각 주문에 대한 세부 정보를 제공합니다. 조회할 주문 아이디를 입력하여 요청하면 해당 주문에 대한 상세 응답을 받아볼 수 있습니다.
해당 API를 사용하려면 Vendor ID와 API 키값이 필요합니다.
발급 방법은 시작하기의 Vendor ID 및 API 키 발급받기를 참고하세요.
Request
요청 호출 방식과 각 요청 헤더에 포함될 내용에 안내합니다. 요청이 실패할 경우 🔗문제 해결하기에서 에러에 대한 상세 내용을 확인하세요.
호출 방식
| Method | URL |
|---|---|
GET | https://open-api-logistics.kakaomobility .com/goa-sandbox-service/api/v2/orders/{partnerOrderId} |
요청 헤더
| Parameter | Description |
|---|---|
| Authorization | 시작하기에서 생성한 Authorization 파라미터 값 |
| vendor | kakaoT 퀵∙도보 배송 API Sandbox에서 발급받은 Vendor 아이디 |
| Content-Type | application/json |
요청 코드 예제
curl -X 'GET' \
'https://open-api-logistics.kakaomobility.com/goa-sandbox-service/api/v2/orders/${partnerOrderId}' \
-H 'accept: application/json' \
-H 'vendor: ${vendor_id}' \
-H 'Authorization: XXX' \
요청에 대한 파라미터는 다음과 같습니다.
| Name | Type | Description | Required |
|---|---|---|---|
partnerOrderId | String | 연동사 주문 아이디 | 필수 |
Response
응답 성공 시 요청에 대한 성공 여부를 HTTP 상태 코드로, 요청 본문은 JSON 포맷으로 전달합니다.
응답 코드 예제
{
"requestId": ${requestId},
"partnerOrderId": ${partnerOrderId},
"pickup": {
"location": {
"basicAddress": "서울 강남구 역삼동 xxx",
"detailAddress": "1층",
"latitude": 37.4354059,
"longitude": 126.74551
},
"contact": {
"name": "전달하는 사람 이름",
"phone": "010-1000-0001"
},
"statusUpdatedAt": "2023-02-27T15:40:32+09:00"
},
"dropoff": {
"location": {
"basicAddress": "서울 강남구 일원동 xxx",
"detailAddress": "2층",
"latitude": 37.569691,
"longitude": 126.825791
},
"contact": {
"name": "받는 사람 이름",
"phone": "010-1000-0002"
},
"statusUpdatedAt": "2023-02-27T15:40:32+09:00"
},
"receipt": {
"orderId": ${orderId},
"orderType": ${orderType},
"status": "MATCHING",
"priceInfo": {
"totalPrice": 100000,
},
},
"histories": [
"status": "MATCHING",
"updatedAt": "2023-02-27T15:40:32+09:00"
]
}요청 응답에 대한 객체 정보는 다음과 같습니다.
| Name | Type | Description | Required |
|---|---|---|---|
requestId | String | 요청 아이디 | 필수 |
partnerOrderId | String | 연동사 주문 아이디 | 필수 |
Object | 출발지 정보 | 필수 | |
Object | 목적지 정보 | 필수 | |
Object | 주문 정보 | 필수 |