오류코드

서버, 통신, 기관 정책, 기관 장애, 엔드 유저 환경, 엔드 유저 인증 등 다양한 조건에 의해 오류가 발생할 수 있습니다.
모든 응답은 HTTP Status Code를 반환하며, 데이터에 상세한 오류코드와 오류 메세지를 포함합니다. 오류코드는 아래와 같이 나눠지며, 메세지에서 각 오류에 대한 자세한 내용을 확인하실 수 있습니다. 추가적으로 궁금한 사항이 있으시다면 문의해주세요.

Code	HTTP Status Code	서비스 종류	설명
AE-001	400 Bad Request	전체	해당하는 사용자가 없어 본인인증에 실패했습니다. 올바른 정보를 입력했는지 요청정보를 다시 한번 확인해주세요.
AE-002	400 Bad Request	HIRA	주민등록번호가 올바르지 않습니다. 주민등록번호를 다시 입력해주세요.
AE-003	400 Bad Request	전체	본인인증 절차가 완료되지 않았습니다. 먼저 본인인증을 완료해주세요.
AE-004	403 Forbidden	HIRA (휴대폰인증)	SMS 인증은 최대 3회까지만 가능합니다. 다시 시도하려면 처음부터 시작해주세요.
AE-005	400 Bad Request	HIRA (휴대폰인증)	인증번호가 일치하지 않습니다. 올바른 인증번호를 입력했는지 확인해주세요.
AE-006	400 Bad Request	전체	2차 인증 토큰이 존재하지 않습니다. 올바른 id와 jti를 입력했는지 확인해주세요.
AG-001	400 Bad Request	전체	제공업체의 간편인증이 원활하게 동작하지 않습니다. 잠시 후 다시 시도해주세요.
AG-002	400 Bad Request	전체	제공업체의 간편인증이 원활하게 동작하지 않습니다. 잠시 후 다시 시도해주세요.
AG-003	400 Bad Request	전체	최근 발생한 SKT 유심정보 유출 사고 관련하여, 의료정보 유출 등의 2차 피해를 예방하기 위해 문자메시지 인증이 한시적으로 중단되었습니다. 서비스 이용을 위해 간편인증을 이용해주시기 바랍니다.
AT-001	403 Forbidden	전체	요청이 이미 만료되었습니다. 처음부터 다시 진행해주세요.
AT-002	401 Unauthorized	전체	API Key를 포함하지 않는 요청입니다. API Key를 포함해주세요.
AT-003	403 Forbidden	전체	API Key가 유효하지 않습니다. 올바른 API Key를 입력했는지 확인해주세요.
AT-004	403 Forbidden	전체	해당 API를 호출할 수 있는 권한이 없습니다. 권한을 확인해주세요.
RE-001	404 Not Found	전체	요청하신 페이지(Resource)를 찾을 수 없습니다.
TE-001	429 Too Many Requests	전체	API 호출 한도에 도달했습니다. 더이상 호출이 불가합니다.
VE-001	422 Unprocessable Entity	전체	요청 파라미터의 필수 값이 누락되었습니다.
VE-002	422 Unprocessable Entity	전체	지원하지 않는 response type입니다. 지원 가능한 값을 입력해주세요.
VE-003	422 Unprocessable Entity	전체	지원하지 않는 요청 날짜 범위입니다. 최근 5년 이내의 날짜를 입력해주세요.
VE-004	422 Unprocessable Entity	NHIS	지원하지 않는 로그인 방식(loginType): 국민건강검진공단은 휴대폰 문자인증을 지원하지 않습니다. 올바른 숫자를 입력해주세요.
VE-006	422 Unprocessable Entity	전체	로그인 방식(loginType): 5는 간편인증, 2는 문자인증 입니다. 올바른 숫자를 입력해주세요.
VE-007	422 Unprocessable Entity	전체	로그인 방식(loginType): 1차 요청과 2차 요청의 로그인 방식이 일치하지 않습니다. 1차 요청에서 선택한 로그인 방식을 유지해주세요.
VE-008	422 Unprocessable Entity	전체	간편인증서(loginTypeLevel): 1, 3~11 사이의 숫자로 인증서의 종류를 선택해주세요. 자세한 내용은 문서를 참고해주세요.
VE-009	422 Unprocessable Entity	전체	본명(legalName): 2~20자의 한글 또는 영문으로 입력해주세요.
VE-010	422 Unprocessable Entity	전체	전화번호(phoneNo): 숫자만 입력해주세요.
VE-011	422 Unprocessable Entity	전체	id: 4~100자 사이의 문자로 입력해주세요.
VE-012	422 Unprocessable Entity	NHIS	생년월일(birthdate): YYYYMMDD 형태로 입력해주세요.
VE-013	422 Unprocessable Entity	HIRA	주민등록번호(identity): 13자리 숫자로 입력해주세요.
VE-014	422 Unprocessable Entity	전체	통신사(telecom): 0~5 사이의 숫자로 통신사를 선택해주세요. 자세한 내용은 문서를 참고해주세요.
VE-015	422 Unprocessable Entity	전체	조회 시작날짜(startDate): yyyy, yyyy-mm, 혹은 yyyy-mm-dd의 형태로 날짜를 입력해주세요.
VE-016	422 Unprocessable Entity	전체	조회 시작날짜(startDate): 1900년 이후의 날짜를 입력해주세요.
VE-017	422 Unprocessable Entity	전체	조회 시작날짜(startDate): 존재하지 않는 날짜입니다. 올바른 날짜를 입력해주세요.
VE-018	422 Unprocessable Entity	전체	조회 종료날짜(endDate): yyyy, yyyy-mm, 혹은 yyyy-mm-dd의 형태로 날짜를 입력해주세요.
VE-019	422 Unprocessable Entity	전체	조회 종료날짜(endDate): 1900년 이후의 날짜를 입력해주세요.
VE-020	422 Unprocessable Entity	전체	조회 시작날짜(startDate): 존재하지 않는 날짜입니다. 올바른 날짜를 입력해주세요.
VE-021	422 Unprocessable Entity	전체	jobIndex: 0~99 사이의 숫자로 입력해주세요.
VE-023	422 Unprocessable Entity	전체	multiFactorTimestamp: 올바른 타임스탬프 값을 입력해주세요.
SE-001	500 Internal Server Error	전체	서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요.
SE-002	500 Internal Server Error	인증서버	정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-003	500 Internal Server Error	인증서버	제공 업체를 확인할 수 없습니다. 관리자에게 문의해주세요.
SE-004	500 Internal Server Error	인증서버	정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-005	500 Internal Server Error	인증서버	보안문자 오류 발생: 서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요.
SE-006~012	500 Internal Server Error	전체	정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
DB-001~003	500 Internal Server Error	전체	서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요.