GenderAPI 오류 코드

응답 구조

오류 객체 읽기

요청이 실패하면 JSON 응답의 status는 false입니다. 애플리케이션 로직에는 숫자 errno를 사용하고, 로그나 사람이 읽는 진단에는 errmsg를 사용하세요.

JSON · 오류 예시

{
  "status": false,
  "errno": 94,
  "errmsg": "invalid or missing key"
}

구현 원칙:errmsg 문구가 아니라 errno를 기준으로 분기하세요. 설명 문구가 바뀌어도 연동 동작을 안정적으로 유지할 수 있습니다.

전체 참고표

다음 값은 현재 공개 GenderAPI 문서와 일치합니다. 요청을 반복하기 전에 원인을 해결하세요.

errno50

access denied

허용되지 않은 IP 주소 또는 리퍼러에서 요청했습니다.

API 키에 설정된 접근 제한을 확인하세요.

errno90

invalid country code

country 값이 지원되는 ISO 3166-1 alpha-2 코드가 아닙니다.

재시도 전에 국가 코드를 검증하고 표준화하세요.

errno91

name not set || email not set || username not set

요청에 필수 name, email 또는 username 매개변수가 없습니다.

호출하는 엔드포인트에 필요한 입력을 추가하세요.

errno92

too many names || too many emails || too many usernames

요청이 이름 100개, 이메일 50개 또는 사용자 이름 50개의 일괄 처리 한도를 초과했습니다.

입력을 더 작은 묶음으로 나누어 별도로 전송하세요.

errno93

query limit reached

API 키에 남은 크레딧이 없습니다.

조회 작업을 중지하고 계정 크레딧을 충전하세요.

errno94

invalid or missing key

API 키가 없거나 찾을 수 없습니다.

인증 정보 전달 방식을 확인하고 유효한 서버 측 키를 사용하세요.

errno99

API key has expired

API 키에 연결된 요금제가 만료되었습니다.

다음 조회 전에 요금제를 갱신하세요.

처리 가이드

안전하게 실패하고 무조건 재시도하지 않기

먼저 입력 검증

필수 입력 누락, 잘못된 국가 코드와 한도 초과 묶음을 API 전송 전에 차단하세요.

인증 정보 보호

API 키는 서버에 보관하고 애플리케이션 로그, 브라우저 출력과 지원용 스크린샷에서 제거하세요.

선별적으로 재시도

이 오류는 입력 수정이나 계정 조치가 필요합니다. 같은 요청을 변경 없이 반복해도 해결되지 않습니다.

TypeScript · 응답 가드

type GenderApiError = {
  status: false;
  errno: number;
  errmsg: string;
};

if (response.status === false) {
  handleGenderApiError(response.errno, response.errmsg);
}

진단 정보는 비공개로 유지하세요

오류 번호와 내부 요청 ID를 함께 기록하되 API 키는 절대 포함하지 마세요. 원시 인증 정보나 내부 요청 데이터를 노출하지 말고 사용자에게 간결하고 실행 가능한 메시지를 표시하세요.

문서 완료

GenderAPI로 계속 개발하기

사용량 및 할당량사용 가능한 크레딧 확인 →요금제크레딧 패키지 비교 →

API 오류를 안정적으로 처리하기

오류 객체 읽기