문제 해결하기
응답 코드
요청 성공 시 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 |
|---|---|---|---|
| -20001 | 400 | "주소가 없거나, 찾지 못했습니다." | 입력한 출발지/목적지의 주소나 위도 또는 경도 값이 올바르지 않음 |
| -20001 | 409 | "중복된 오더입니다." | 같은 주문 정보로 이미 요청된 주문이 존재함 |
| -20002 | 400 | "도보 배송 가능 거리가 아닙니다." | 도보 배송 요청 거리가 1 km 이상으로 설정됨 |
| -20003 | 400 | "주문 번호가 존재하지 않습니다." | 요청한 주문 ID가 시스템에 등록되어 있지 않음 |
| -20006 | 400 | "올바르지 못한 주문입니다." | 주문 요청 시 입력한 출발지/목적지 값이 올바르지 않음 |
| -20007 | 400 | "예약 일시가 올바르지 않습니다." | 예약 일시가 형식에 맞지 않거나 과거 혹은 너무 먼 미래 시간임 |
| -20008 | 400 | "목표 일시가 올바르지 않습니다." | 배송 목표 시간이 형식 오류이거나 논리적으로 유효하지 않음 |
| -20009 | 400 | "픽업시간이 올바르지 않습니다." | 픽업 시간이 현재보다 과거이거나 올바르지 못할 때 |
| -20010 | 404 | "존재하지 않는 주문 입니다." | 존재하지 않은 주문 아이디로 요청함 |
| -20011 | 400 | "올바르지 못한 파라미터입니다." | 요청에 전달된 파라미터 값이 잘못되었음 |
| -20011 | 400 | "조회 가능 기간이 지났습니다." | 조회 요청한 기간이 시스템에서 허용하는 범위를 초과함 |
| -20012 | 400 | "요청보낸 주소지가 정확하지 않습니다." | 출발지 또는 목적지 주소 정보가 불완전하거나 오타가 있음 |
| -20012 | 400 | "매칭 할 수 없는 주문 건입니다." | 해당 주문이 현재 매칭 불가능한 상태임 |
| -20013 | 400 | "오더의 상태가 유효하지 않습니다." | 변경할 수 없는 상태로 주문 상태 변경 요청함. (ex. 이미 취소한 주문에 대해서 취소 요청) |
| -20014 | 400 | "매칭중인 오더가 있습니다." | 이미 매칭 중인 주문이 있어 추가 매칭 요청이 불가능함 |
| -20015 | 400 | "수행중인 오더가 아닙니다." | 완료 또는 취소된 주문에 대해 작업을 시도함 |
| -20016 | 400 | "오더를 완료할 수 없습니다." | 주문 상태가 완료 처리할 수 없는 상태임 |
| -20017 | 423 | "이미 매칭된 오더입니다." | 이미 배차가 완료된 주문에 대해 매칭 요청함 |
| -20018 | 400 | "취소수수료 불일치" | 취소수수료 불일치 |
| -20019 | 400 | "이미 취소되었거나 취소 불가능한 오더입니다." | 취소 불가능한 주문인데 취소 시도시 |
| -20020 | 400 | "좌표와 주소지가 5 KM 이상 차이납니다." | 입력한 출발지/목적지의 주소와 좌표 정보(각각의 출발지와 목적지의 위도/경도값)가 5 km 이상 차이가 남 |
| -20021 | 400 | "픽업 목표 시간이 올바르지 않습니다." | 픽업 또는 배송 목표 시간이 예약 규칙에 맞지 않음 |
| -20022 | 400 | "서드파티 에러입니다" | 외부 서비스 호출 중 예기치 않은 에러 발생함 |
| -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 | "해당 빌링 아이템을 이용할 수 없는 그룹입니다." | 그룹 설정에서 사용하지 않음으로 설정한 서비스의 아이템 아이디를 전달받음 |
| -60009 | 400 BAD_REQUEST | "해당 빌링 아이템을 이용할 수 없는 그룹입니다." | 요청한 빌링 항목을 해당 고객 그룹이 사용할 권한이 없음 |
| -60010 | 400 BAD_REQUEST | "미수 내역이 존재합니다." | 미결제 내역이 있어 요청 작업이 제한됨 |
| -90001 | 400 BAD_REQUEST | "카드가 그룹에 등록되어 있지 않습니다." | 결제에 사용된 카드가 그룹에 연동되지 않음 |
| -90002 | 404 BAD_REQUEST | "비즈 설정이 잘못되었습니다." | 비즈니스 계정 설정이 유효하지 않거나 누락됨 |
| -90003 | 400 BAD_REQUEST | "비즈 그룹 ID가 올바르지 않습니다." | 요청한 비즈 그룹 ID가 존재하지 않거나 형식이 잘못됨 |
| code | status | message | Description |
|---|---|---|---|
| 90001 | 500 | "서버 에러가 발생하였습니다." | 내부 서버 오류 |
| 90002 | 401 | "유효하지 않거나 만료된 토큰입니다." | authorization 파라미터 값이 유효하지 않거나 유효 시간이 만료됨 |
| 90006 | 401 | "허용 되지 않은 접근 입니다." | 허용되지 않은 URL 주소로 접근함 |
| 90007 | 401 | "등록 되지 않은 vendor 정보 입니다." | 등록되지 않은 vendor 정보를 입력함 |
| 90011 | 412 | "필수 파라미터(vendor)를 확인해주세요." | 요청 헤더에 vendor 정보가 누락됨 |
| 90012 | 412 | "필수 파라미터(authorization)를 확인해주세요." | 요청 헤더에 authorization 정보가 누락됨 |