오류코드
서버, 통신, 기관 정책, 기관 장애, 엔드 유저 환경,
엔드 유저 인증 등 다양한 조건에 의해 오류가 발생할 수 있습니다.
모든 응답은 HTTP Status Code를 반환하며, 데이터에 상세한 오류코드와 오류 메세지를 포함합니다.
오류코드는 아래와 같이 나눠지며, 메세지에서 각 오류에 대한 자세한 내용을 확인하실 수 있습니다. 추가적으로 궁금한 사항이 있으시다면 문의해주세요.
AE-001
400
해당하는 사용자가 없어 본인인증에 실패했습니다. 요청정보를 다시 한번 확인해주세요.
AE-002
400
주민등록번호가 올바르지 않습니다. 주민등록번호를 다시 입력해주세요.
AE-003
400
본인인증 절차가 완료되지 않았습니다. 먼저 본인인증을 완료해주세요.
AE-004
403
SMS 인증은 최대 3회까지만 가능합니다. 다시 시도하려면 처음부터 시작해주세요.
AE-005
400
인증번호가 일치하지 않습니다. 올바른 인증번호를 입력했는지 확인해주세요.
AE-006
400
2차 인증 토큰이 존재하지 않습니다. 올바른 id와 jti를 입력했는지 확인해주세요.
AG-001
400
제공 업체의 간편인증 요청이 원활하지 않습니다. 잠시 후 다시 시도해주세요.
AG-002
400
간편인증 연결이 일시적으로 원활하지 않습니다. 잠시 후 다시 시도해 주세요.
AG-003
400
최근 발생한 SKT 유심정보 유출 사고 관련하여, 의료정보 유출 등의 2차 피해를 예방하기 위해 문자메시지 인증이 한시적으로 중단되었습니다. 서비스 이용을 위해 간편인증을 이용해주시기 바랍니다.
AG-004
400
정보 제공 서버의 로그인 모듈 오류가 발생해, 간편인증이 중단되었습니다. 처음부터 다시 시도해주세요.
AG-005
400
정보 제공 서버가 원활하지 않아 네트워크 시간 초과로 인증에 실패했습니다. 처음부터 다시 시도해주세요.
AT-001
403
요청이 이미 만료되었습니다. 처음부터 다시 진행해주세요.
AT-002
401
API Key를 포함하지 않는 요청입니다. API Key를 포함해주세요.
AT-003
403
API Key가 유효하지 않습니다.
AT-004
403
해당 API를 호출할 수 있는 권한이 없습니다.
DB-001
500
서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요.
DB-002
500
서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요.
DB-003
500
서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요.
SE-001
500
서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요.
SE-002
500
정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-003
500
정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-004
500
정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-005
500
정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-006
500
정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-007
500
정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-008
500
정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-009
500
정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-010
500
정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-011
500
정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다.
SE-012
500
서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요.
SE-013
500
서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요.
SE-014
500
서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요.
TE-001
429
API 호출 한도에 도달했습니다. 더이상 호출이 불가합니다.
VE-002
422
지원하지 않는 response type입니다. 지원 가능한 값을 입력해주세요.
VE-003
422
지원하지 않는 요청 날짜 범위입니다. 최근 5년 이내의 날짜를 입력해주세요.
VE-004
422
국민건강검진공단은 휴대폰 문자인증을 지원하지 않습니다. 올바른 숫자를 입력해주세요.
VE-005
422
OO 필드가 누락되었습니다. 필드를 확인해주세요.
VE-006
422
5는 간편인증, 2는 문자인증 입니다. 올바른 숫자를 입력해주세요.
VE-007
422
1차 요청과 2차 요청의 로그인 방식이 일치하지 않습니다. 1차 요청에서 선택한 로그인 방식을 유지해주세요.
VE-008
422
1, 3~11 사이의 숫자로 인증서의 종류를 선택해주세요. 자세한 내용은 문서를 참고해주세요.
VE-009
422
2~20자의 한글 또는 영문으로 입력해주세요.
VE-010
422
숫자만 입력해주세요.
VE-011
422
4~100자 사이의 문자로 입력해주세요.
VE-012
422
YYYYMMDD 형태로 입력해주세요.
VE-013
422
13자리 숫자로 입력해주세요.
VE-014
422
0~5 사이의 숫자로 통신사를 선택해주세요. 자세한 내용은 문서를 참고해주세요.
VE-015
422
yyyy, yyyy-mm, 혹은 yyyy-mm-dd의 형태로 날짜를 입력해주세요.
VE-016
422
1900년 이후의 날짜를 입력해주세요.
VE-017
422
존재하지 않는 날짜입니다. 올바른 날짜를 입력해주세요.
VE-018
422
yyyy, yyyy-mm, 혹은 yyyy-mm-dd의 형태로 날짜를 입력해주세요.
VE-019
422
1900년 이후의 날짜를 입력해주세요.
VE-020
422
존재하지 않는 날짜입니다. 올바른 날짜를 입력해주세요.
VE-021
422
0~99 사이의 숫자로 입력해주세요.
VE-022
422
0~99 사이의 숫자로 입력해주세요.
VE-023
422
올바른 타임스탬프 값을 입력해주세요.
VE-024
422
SMS 인증번호가 유효한 형태가 아닙니다. 6자리 숫자의 형태로 입력해주세요.
| Code | HTTP 응답코드 | 오류 구분 | 설명 |
|---|---|---|---|
AE-001
|
400 bad request | 인증오류 | 해당하는 사용자가 없어 본인인증에 실패했습니다. 요청정보를 다시 한번 확인해주세요. |
AE-002
|
400 bad request | 인증오류 | 주민등록번호가 올바르지 않습니다. 주민등록번호를 다시 입력해주세요. |
AE-003
|
400 bad request | 인증오류 | 본인인증 절차가 완료되지 않았습니다. 먼저 본인인증을 완료해주세요. |
AE-004
|
403 forbidden | 인증오류 | SMS 인증은 최대 3회까지만 가능합니다. 다시 시도하려면 처음부터 시작해주세요. |
AE-005
|
400 bad request | 인증오류 | 인증번호가 일치하지 않습니다. 올바른 인증번호를 입력했는지 확인해주세요. |
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차 피해를 예방하기 위해 문자메시지 인증이 한시적으로 중단되었습니다. 서비스 이용을 위해 간편인증을 이용해주시기 바랍니다. |
AG-004
|
400 bad request | 인증기관오류 | 정보 제공 서버의 로그인 모듈 오류가 발생해, 간편인증이 중단되었습니다. 처음부터 다시 시도해주세요. |
AG-005
|
400 bad request | 인증기관오류 | 정보 제공 서버가 원활하지 않아 네트워크 시간 초과로 인증에 실패했습니다. 처음부터 다시 시도해주세요. |
AT-001
|
403 forbidden | 인증토큰오류 | 요청이 이미 만료되었습니다. 처음부터 다시 진행해주세요. |
AT-002
|
401 unauthorized | 인증토큰오류 | API Key를 포함하지 않는 요청입니다. API Key를 포함해주세요. |
AT-003
|
403 forbidden | 인증토큰오류 | API Key가 유효하지 않습니다. |
AT-004
|
403 forbidden | 인증토큰오류 | 해당 API를 호출할 수 있는 권한이 없습니다. |
DB-001
|
500 internal Server Error | 데이터베이스오류 | 서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요. |
DB-002
|
500 internal Server Error | 데이터베이스오류 | 서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요. |
DB-003
|
500 internal Server Error | 데이터베이스오류 | 서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요. |
SE-001
|
500 internal Server Error | 서버오류 | 서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요. |
SE-002
|
500 internal Server Error | 서버오류 | 정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다. |
SE-003
|
500 internal Server Error | 서버오류 | 정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다. |
SE-004
|
500 internal Server Error | 서버오류 | 정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다. |
SE-005
|
500 internal Server Error | 서버오류 | 정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다. |
SE-006
|
500 internal Server Error | 서버오류 | 정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다. |
SE-007
|
500 internal Server Error | 서버오류 | 정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다. |
SE-008
|
500 internal Server Error | 서버오류 | 정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다. |
SE-009
|
500 internal Server Error | 서버오류 | 정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다. |
SE-010
|
500 internal Server Error | 서버오류 | 정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다. |
SE-011
|
500 internal Server Error | 서버오류 | 정보수집 서버 접속에 실패했습니다. 동일 현상이 10분 이상 반복되면 관리자에게 문의 바랍니다. |
SE-012
|
500 internal Server Error | 서버오류 | 서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요. |
SE-013
|
500 internal Server Error | 서버오류 | 서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요. |
SE-014
|
500 internal Server Error | 서버오류 | 서버 처리중 에러가 발생 했습니다. 관리자에게 문의하세요. |
TE-001
|
429 too many requests | 요청제한오류 | API 호출 한도에 도달했습니다. 더이상 호출이 불가합니다. |
VE-002
|
422 invalid | 검증오류 | 지원하지 않는 response type입니다. 지원 가능한 값을 입력해주세요. |
VE-003
|
422 invalid | 검증오류 | 지원하지 않는 요청 날짜 범위입니다. 최근 5년 이내의 날짜를 입력해주세요. |
VE-004
|
422 invalid | 검증오류 | 국민건강검진공단은 휴대폰 문자인증을 지원하지 않습니다. 올바른 숫자를 입력해주세요. |
VE-005
|
422 invalid | 검증오류 | OO 필드가 누락되었습니다. 필드를 확인해주세요. |
VE-006
|
422 invalid | 검증오류 | 5는 간편인증, 2는 문자인증 입니다. 올바른 숫자를 입력해주세요. |
VE-007
|
422 invalid | 검증오류 | 1차 요청과 2차 요청의 로그인 방식이 일치하지 않습니다. 1차 요청에서 선택한 로그인 방식을 유지해주세요. |
VE-008
|
422 invalid | 검증오류 | 1, 3~11 사이의 숫자로 인증서의 종류를 선택해주세요. 자세한 내용은 문서를 참고해주세요. |
VE-009
|
422 invalid | 검증오류 | 2~20자의 한글 또는 영문으로 입력해주세요. |
VE-010
|
422 invalid | 검증오류 | 숫자만 입력해주세요. |
VE-011
|
422 invalid | 검증오류 | 4~100자 사이의 문자로 입력해주세요. |
VE-012
|
422 invalid | 검증오류 | YYYYMMDD 형태로 입력해주세요. |
VE-013
|
422 invalid | 검증오류 | 13자리 숫자로 입력해주세요. |
VE-014
|
422 invalid | 검증오류 | 0~5 사이의 숫자로 통신사를 선택해주세요. 자세한 내용은 문서를 참고해주세요. |
VE-015
|
422 invalid | 검증오류 | yyyy, yyyy-mm, 혹은 yyyy-mm-dd의 형태로 날짜를 입력해주세요. |
VE-016
|
422 invalid | 검증오류 | 1900년 이후의 날짜를 입력해주세요. |
VE-017
|
422 invalid | 검증오류 | 존재하지 않는 날짜입니다. 올바른 날짜를 입력해주세요. |
VE-018
|
422 invalid | 검증오류 | yyyy, yyyy-mm, 혹은 yyyy-mm-dd의 형태로 날짜를 입력해주세요. |
VE-019
|
422 invalid | 검증오류 | 1900년 이후의 날짜를 입력해주세요. |
VE-020
|
422 invalid | 검증오류 | 존재하지 않는 날짜입니다. 올바른 날짜를 입력해주세요. |
VE-021
|
422 invalid | 검증오류 | 0~99 사이의 숫자로 입력해주세요. |
VE-022
|
422 invalid | 검증오류 | 0~99 사이의 숫자로 입력해주세요. |
VE-023
|
422 invalid | 검증오류 | 올바른 타임스탬프 값을 입력해주세요. |
VE-024
|
422 invalid | 검증오류 | SMS 인증번호가 유효한 형태가 아닙니다. 6자리 숫자의 형태로 입력해주세요. |
- 오류 코드와 메시지를 확인하여 문제를 파악하세요
- 문제가 지속되면 고객센터로 문의해주세요
