오류코드

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

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 호출 한도에 도달했습니다. 더이상 호출이 불가합니다. 프리미엄 플랜을 신청하시기 최근 발생한 SKT 유심정보 유출 사고 관련하여, 의료정보 유출 등의 2차 피해를 예방하기 위해 문자메시지 인증이 한시적으로 중단되었습니다. 서비스 이용을 위해 간편인증을 이용해주시기 바랍니다.

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 검증오류

11자리의 숫자로 입력해주세요. 앞자리가 010, 011, 016, 017, 018, 019 중 하나여야 합니다.

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자리 숫자의 형태로 입력해주세요.

오류 발생 시 안내
  • 오류 코드와 메시지를 확인하여 문제를 파악하세요
  • 문제가 지속되면 고객센터로 문의해주세요
-->