다크 모드
레퍼런스
대중교통 통합 길찾기 API에서 사용하는 공통 클래스 정보를 안내합니다.
공통 에러 코드
다음은 대중교통 통합 길찾기 API에서 발생할 수 있는 에러 코드 정보입니다. 에러 발생 시 code 중 해당하는 항목을 찾아 원인을 파악할 수 있습니다.
예제 응답 (예기치 못한 서버 오류 발생 시):
bash
{ "code": -1, "msg": "internal server error"}일반적인 탐색 실패가 아닌 서버 오류나 사용자 입력 오류가 발생한 경우, 위와 같은 JSON 형식으로 응답이 전달됩니다. 자세한 에러 코드 정보는 문제 해결하기에서 상세 내용을 확인하세요.
| Code | HTTP status code | Description |
|---|---|---|
| -1 | 500 | 서버 내부에서 처리 중에 에러가 발생한 경우 해결 방법: 재시도 |
| -2 | 400 | 필수 인자가 포함되지 않은 경우나 호출 인자 값의 데이터 타입이 적절하지 않거나 허용된 범위를 벗어난 경우 해결 방법: 요청 파라미터 확인 |
| -3 | 403 | 해당 API를 사용하기 위해 필요한 기능(간편 가입, 동의 항목, 서비스 설정 등)이 활성화되지 않은 경우 해결 방법: 카카오디벨로퍼스의 앱에서 필요한 기능을 선택한 후, [활성화 설정]에서 ON으로 설정한 후 재호출 |
| -4 | 403 | 계정이 제재된 경우나 해당 계정에 제재된 행동을 하는 경우 |
| -5 | 403 | 해당 API에 대한 요청 권한이 없는 경우 해결 방법: 검수 진행하여 권한 획득 후 재호출 |
| -7 | 500 | 서비스 점검 또는 내부 문제가 있는 경우 |
| -8 | 400 | 올바르지 않은 헤더로 요청한 경우 해결 방법: 요청 헤더 확인 |
| -9 | 400 | 서비스가 종료된 API를 호출한 경우 |
| -10 | 400 | 허용된 요청 회수가 초과한 경우 해결 방법: 허용된 쿼터 확인 후 쿼터 범위 내로 호출 조정, 쿼터 및 제한 참고 |
| -401 | 401 | 유효하지 않은 앱 키나 액세스 토큰으로 요청한 경우, 등록된 앱 정보와 호출된 앱 정보가 불일치하는 경우 해결 방법: 앱 키(App Key) 확인 또는 토큰 갱신, 개발자 사이트에 등록된 앱 정보 확인 |
| -602 | 400 | 이미지 업로드 시 최대 용량을 초과하였을 경우 |
| -603 | 400 | 이미지 업로드나 스크랩 요청과 같이 오래 걸리는 작업이 필요한 API에서 수행 시간이 오래 걸리는 경우 |
| -903 | 400 | 등록되지 않은 개발자의 앱 키나 등록되지 않은 개발자의 앱 키로 구성된 액세스 토큰으로 요청한 경우 |
| -911 | 400 | 지원하지 않는 포맷의 이미지를 업로드하는 경우 |
| -9798 | 503 | 서비스 점검 중 |
경로 탐색 결과 코드
응답 바디의 result_code에 대한 상세 정보는 다음과 같습니다.
| Code | Message | Description |
|---|---|---|
| 0 | 성공 | 길찾기 성공 |
| 1 | 경로 탐색 실패 | 확인되지 않은 오류 또는 목적지로 가는 노선 정보 없음 |
| 2 | 출발지를 찾을 수 없습니다 | 출발역을 탐색할 수 없음 |
| 3 | 목적지를 찾을 수 없습니다 | 도착역을 탐색할 수 없음 |
| 4 | 경유지를 찾을 수 없습니다 | 경유역을 탐색할 수 없음 |
| 202 | Invalid Parameter | 요청 파라미터 값에 오류가 있음 |
| 204 | 출발지가 없습니다 | 요청 정보에 출발지 정보가 없음 |
| 205 | 목적지가 없습니다 | 요청 정보에 목적지 정보가 없음 |
| 300 | Internal Server Error | 서버 내부 오류 |
| 1001 | 요청한 시간에 출발 또는 도착 가능한 노선이 없음 | 사용자가 요청한 시간에 운행 가능한 노선이 없음 |