버전
| 날짜 | 변경사항 |
|---|---|
| 2021-12-21 | 최초 작성 |
| 2022-02-17 | - Secret 검증 오류 상태 변경 (400 -> 401) - 요청ID 중복 에러추가(0012) - 0027 에러코드 추가 |
| 2022-04-21 | - 0510 에러코드 추가 - 진위검증 기관 에러메시지 추가 |
| 2022-07-21 | - 면허번호 에러메시지 추가 |
| 2023-02-23 | - 진위검증 에러코드 및 개선된 메시지 목록 추가 |
에러코드
| HTTP 상태 | 설명 |
|---|---|
| 400 | 요청에러 |
| 401 | 권한에러 |
| 500 | 내부서버에러 |
에러응답:
| 에러코드 | HTTP 상태 | 메시지 | 설명 |
|---|---|---|---|
| 0001 | 400 | URL is invalid. | URL 오류 |
| 0002 | 401 | Secret key validate failed. | Secret 검증 오류 |
| 0011 | 400 | Request body invalid. | 요청값 오류 |
| 0012 | 400 | RequestId is duplicated. | 요청ID가 중복된 경우 |
| 0022 | 400 | Request domain invalid. | 도메인 조회가 불가능한 경우 |
| 0024 | 400 | Data is duplicated. | 요청데이터 중복 오류 |
| 0025 | 400 | Calls to this api have exceeded the rate limit. | 일시적으로 API 호출 허용량을 초과한 경우 (도메인별) |
| 0027 | 400 | The system is busy. | 일시적으로 API 호출 허용량을 초과한 경우 |
| 0500 | 500 | Unknown service error. | 알 수 없는 오류 |
| 0501 | 500 | OCR service error. | OCR 엔진에서 발생한 오류 |
| 0509 | 500 | Verify service error. | 진위검증 시 오류가 발생하거나 특정할 수 없는 원인으로 실패한 경우 |
| 0510 | 500 | IDCard verification is locked. | 주민등록증 진위검증 시 발급일자 입력오류가 5회 이상 발생하여 요청이 잠긴 경우 정부24(gov.kr) > 서비스 > 신청/확인/공유 > 사실/진위확인 > 주민등록증 진위확인/잠김해제 에서 간편인증서 혹은 공동인증서로 인증 후 해제가능 |
| 0511 | 200 | 진위검증 기관 에러메시지 참조 | 입력값 오류로 진위검증에 실패한 경우 |
| 0512 | 200 | 진위검증 기관 에러메시지 참조 | 신분증이 만료되거나 분실 신고된 경우 |
| 0590 | 200 | 진위검증 기관 에러메시지 참조 | 등록되지 않은 사업자등록번호인 경우 |
| 0591 | 200 | 진위검증 기관 에러메시지 참조 | 폐업된 사업자등록번호인 경우 |
| 0592 | 200 | 진위검증 기관 에러메시지 참조 | 휴업상태의 사업자등록번호인 경우 |
| 0600 | 400 | Trial usage error. | Trial 요금제 사용 시 도메인이 만료되거나 사용횟수를 초과한 경우 |
진위검증 기관 에러 메시지
참고
- 제3 인증 기관에서 반환하는 메시지입니다.
- 아래 메시지는 향후 숫자 및 코드를 제거하고 최신화할 예정입니다.
- 예를 들면 '1012:****:여권정보가 일치하지 않습니다.' 는 '여권정보가 일치하지 않습니다.' 로 변경됩니다.
- 메시지 분기 처리가 필요한 경우에는 되도록 code 필드를 활용해 주세요. 메시지는 인증 기관에 의해 변경될 수 있습니다.
| 검증 유형 | code | 메시지 |
|---|---|---|
| 주민등록증 | 0511 | 335:****:인적자료(성명, 주민번호)를 잘못 입력하였습니다. |
| 외국인등록증 | 0511 | 1104:****:민원인의 정보를 확인할 수 없습니다.민원신청을 원할시 관할 출입국.외국인관서로 문의 바랍니다. |
| 외국인등록증 | 0512 | 1104::법무부가 보유한 정보와 일치하나 분실 또는 발급 취소한 외국인 등록번호 입니다. |
| 운전면허증 | 0511 | 716:****:면허 번호가 일치하지 않음 |
| 운전면허증 | 0511 | 217:****: 도로교통공단 전산 자료와 일치하지 않습니다. |
| 운전면허증 | 0511 | 217:****:인적 정보를 잘못 입력하였습니다. |
| 운전면허증 | 0511 | 217:****:암호일련번호가 일치하지 않습니다. |
| 여권 | 0511 | 1012:****:여권정보가 일치하지 않습니다. |
| 사업자등록증 | 0590 | 조회하신 사업자등록번호는 현재 등록되어 있지 않습니다. |
| 사업자등록증 | 0591 | 폐업 사업자입니다. |
| 사업자등록증 | 0592 | 휴업 사업자입니다. |