문제 해결하기
응답 코드
요청 성공 시 HTTP 200번대 상태 코드와 함께 요청에 대한 응답 바디(response body)가 반환되고, API 요청에 오류가 발생할 경우 HTTP 400번대 상태 코드와 함께 해당 오류의 원인을code와 status, message로 이루어진 응답 바디(response body)가 반환 됩니다.
아래는 실패한 API 요청의 예시입니다.
{
"requestId": "09b709af-fbdb-436a-9903-68ea83798a38",
"code": -20010,
"status": 404,
"message": "존재하지 않는 주문 입니다."
}HTTP 상태 코드
카카오 T 퀵∙도보 배송 API는 HTTP 상태 코드별로 API 상태 코드와 메시지를 확인할 수 있습니다.
| code | status | message | Description |
|---|---|---|---|
| -20006 | 400 | "올바르지 못한 주문입니다." | 주문 요청 시 입력한 출발지/목적지 값이 올바르지 않음 |
| -20001 | 400 | "주소가 없거나, 찾지 못했습니다." | 입력한 출발지/목적지의 주소나 위도 또는 경도 값이 올바르지 않음 |
| -20009 | 400 | "픽업시간이 올바르지 않습니다." | 픽업 시간이 현재보다 과거이거나 올바르지 못할 때 |
| -20002 | 400 | "도보 배송 가능 거리가 아닙니다." | 도보 배송 요청 거리가 1 km 이상으로 설정됨 |
| -20010 | 404 | "존재하지 않는 주문 입니다." | 존재하지 않은 주문 아이디로 요청함 |
| -20013 | 400 | "오더의 상태가 유효하지 않습니다." | 변경할 수 없는 상태로 주문 상태 변경 요청함. (ex. 이미 취소한 주문에 대해서 취소 요청) |
| -20019 | 400 | "이미 취소되었거나 취소 불가능한 오더입니다." | 취소 불가능한 주문인데 취소 시도시 |
| -20020 | 400 | "좌표와 주소지가 5 KM 이상 차이납니다." | 입력한 출발지/목적지의 주소와 좌표 정보(각각의 출발지와 목적지의 위도/경도값)가 5 km 이상 차이가 남 |
| -30001 | 404 | "기사를 찾을 수 없습니다." | 해당 주문에 배정할 수 있는 기사가 없음 |
| -50001 | 500 | "운영 시간이 아닙니다." | 도보의 경우 운영 시간 이후에는 주문이 불가 |
| -50003 | 500 | "서버에 에러가 발생했습니다." | 내부 서버 오류 |
| -50004 | 400 | "지원하지 않는 배송 상품 크기 입니다." | 지원하는 배송 상품 크기의 범위를 벗어남 |
| -50006 | 400 | "안전 배송을 지원하지 않습니다." | 선택한 서비스가 안전 배송을 지원하지 않음 |
| code | status | message | Description |
|---|---|---|---|
| -60001 | 400 BAD_REQUEST | "빌링 필수 파라미터중에 없는 것이 있습니다." | API 요청에 필요한 파라미터 값이 전달되지 않음 |
| -60002 | 400 BAD_REQUEST | "빌링 결제 타입이 올바르지 않습니다." | 그룹에서 설정한 결제 방식과 다른 결제 방식을 사용함 |
| -60003 | 400 BAD_REQUEST | "빌링 버티컬 코드가 유효하지 않습니다." | 지원하지 않은 서비스의 코드를 사용함. (ex. 비즈에서 지원하지 않는 PET 서비스의 아이디 사용) |
| -60004 | 400 BAD_REQUEST | "빌링 아이템이 유효하지 않습니다." | 결제할 아이템이 유효하지 않음 |
| -60005 | 400 BAD_REQUEST | "그룹이 해당 버티컬을 이용할 수 없습니다." | 그룹 설정에서 사용하지 않음으로 설정한 서비스에 대한 요청이 들어옴 |
| -60006 | 400 BAD_REQUEST | "그룹에 할당된 카드가 없습니다." | 그룹 설정에서 결제 시 사용할 카드를 등록하지 않음 |
| -60007 | 400 BAD_REQUEST | "카드가 유효하지 않습니다." | 결제하려는 카드가 사용할 수 없는 상태임 (ex: 휴면 상태인 카드) |
| -60008 | 400 BAD_REQUEST | "존재하지 않는 그룹입니다." | 그룹 아이디값을 잘못 입력함 |
| -60008 | 400 BAD_REQUEST | "해당 빌링 아이템을 이용할 수 없는 그룹입니다." | 그룹 설정에서 사용하지 않음으로 설정한 서비스의 아이템 아이디를 전달받음 |
| -60008 | 400 BAD_REQUEST | "미수 내역이 존재합니다." | 미결제 내역이 존재함 |
| code | status | message | Description |
|---|---|---|---|
| 90001 | 500 | "서버 에러가 발생하였습니다." | 내부 서버 오류 |
| 90002 | 401 | "유효하지 않거나 만료된 토큰입니다." | authorization 파라미터 값이 유효하지 않거나 유효 시간이 만료됨 |
| 90006 | 401 | "허용 되지 않은 접근 입니다." | 허용되지 않은 URL 주소로 접근함 |
| 90007 | 401 | "등록 되지 않은 vendor 정보 입니다." | 등록되지 않은 vendor 정보를 입력함 |
| 90011 | 412 | "필수 파라미터(vendor)를 확인해주세요." | 요청 헤더에 vendor 정보가 누락됨 |
| 90012 | 412 | "필수 파라미터(authorization)를 확인해주세요." | 요청 헤더에 authorization 정보가 누락됨 |