가격 조회하기
각 주문에 대한 배송 가격 정보를 제공합니다. 배송 가격을 조회할 주문 정보를 입력하여 요청하면 해당 주문에 대한 가격을 받아 볼 수 있습니다.
해당 API를 사용하려면 Vendor ID와 API 키값이 필요합니다.
발급 방법은 시작하기의 Vendor ID 및 API 키 발급받기를 참고하세요.
Request
요청 호출 방식과 각 요청 헤더에 포함될 내용에 안내합니다. 요청이 실패할 경우 🔗문제 해결하기에서 에러에 대한 상세 내용을 확인하세요.
호출 방식
| Method | URL |
|---|---|
POST | https://open-api-logistics.kakaomobility .com/goa-sandbox-service/api/v2/orders/price |
요청 헤더
| Parameter | Description |
|---|---|
| Authorization | 시작하기에서 생성한 Authorization 파라미터 값 |
| vendor | kakaoT 퀵∙도보 배송 API Sandbox에서 발급받은 Vendor 아이디 |
| Content-Type | application/json |
요청 코드 예제
퀵 주문
curl -X 'POST' \
'https://open-api-logistics.kakaomobility.com/goa-sandbox-service/api/v2/orders/price' \
-H 'accept: application/json' \
-H 'vendor:${vendor_id}' \
-H 'Content-Type: application/json' \
-H 'Authorization: XXX' \
-d '{
"orderType": "QUICK",
"pickup": {
"location": {
"basicAddress": "서울특별시 강남구 역삼동 754",
"detailAddress": "1층",
"latitude": 37.498551,
"longitude": 127.0464387
}
},
"dropoff": {
"location": {
"basicAddress": "서울특별시 강남구 일원동 741",
"detailAddress": "2층",
"latitude": 37.490694420048,
"longitude": 127.079607
}
},
"productSize": "XS"
}'요청에 대한 바디는 다음과 같습니다.
| Name | Type | Description | Required |
|---|---|---|---|
orderType | Enum | 주문 유형 다음 중 하나: QUICK: 퀵QUICK_ECONOMY: 퀵 이코노미QUICK_EXPRESS: 퀵 급송DOBO: 도보 배송 | 필수 |
size | Enum | 상품 크기 다음 중 하나: XS: 서류, 초소형S: 소형M: 중형L: 대형 | 필수 |
Object | 출발지 정보 | 필수 | |
Object | 목적지 정보 | 필수 | |
Object | 기타 옵션 | 선택 | |
Object | 차량 선택 (퀵, size "L"인 경우에는 필수입니다.) | 선택 |
Response
응답 성공 시 요청에 대한 성공 여부를 HTTP 상태 코드로, 요청 본문은 JSON 포맷으로 전달합니다.
응답 코드 예제
{
"totalPrice": 17800
"maximum": 17800 // 도보 min max
"minimum": 15000 // 퀵은 null
}요청 응답에 대한 객체 정보는 다음과 같습니다.
| Name | Type | Description | Required |
|---|---|---|---|
totalPrice | Integer | 총 가격 | 필수 |
maximum | Integer | 최대 가격 | 선택 |
minimum | Integer | 최소 가격 | 선택 |