할당량 개요
처리 전에 사용 가능량 확인
모니터링 작업, 내부 대시보드 또는 일괄 처리 흐름에서 남은 크레딧 엔드포인트를 사용하세요. 성별 조회를 수행하지 않고 간단한 응답을 반환합니다.
남은 크레딧9,443사용 가능한 요청
요금제 상태 활성예시 응답 기준
만료 시각1752651601UNIX 타임스탬프
GET
남은 크레딧 엔드포인트
할당량 정보 조회하기
API 키를 key 쿼리 매개변수로 추가하세요. 방문자에게 인증 정보가 노출되지 않도록 서버 측에서 요청해야 합니다.
https://api.genderapi.io/api/remaining?key=YOUR_API_KEYcURL
curl "https://api.genderapi.io/api/remaining?key=YOUR_API_KEY"인증 정보 보안: 공개 브라우저 JavaScript에서 이 엔드포인트를 직접 호출하지 마세요. 백엔드, 예약 작업 또는 보호된 서버 함수에서 실행하세요.
응답 예시
잔액과 만료 시각
JSON
{
"status": true,
"remaining": 9443,
"expiresAt": 1752651601
}응답 필드
| 필드 | 유형 | 설명 |
|---|---|---|
status | boolean | 요청이 성공하고 API 키가 유효하면 true입니다. |
remaining | integer | 현재 사용할 수 있는 API 크레딧 수입니다. |
expiresAt | integer | 요금제 만료 시각을 초 단위 UNIX 타임스탬프로 표시합니다. |
운영 가이드
할당량이 부족해지기 전에 대응하는 모니터링
현재 사용 가능량 표시
운영 및 지원 팀의 내부 대시보드에 잔액을 표시하세요.
경고 기준 설정
잔액이 0이 되기 전에 알림을 보내 크레딧을 충전할 시간을 확보하세요.
일괄 작업 보호
작업 시작 전에 사용 가능한 크레딧과 예정된 처리량을 비교하세요.
경고 정책 예시
하나의 고정값 대신 트래픽에 맞는 기준을 사용하세요.
- 정상20% 초과 남음
- 주의10~20% 남음
- 위험10% 미만 남음
할당량 소진에 대비하세요
API 오류가 발생한 뒤에야 잔액 소진을 확인하지 마세요. 적절한 주기로 모니터링하고 개별 조회마다 확인하는 것은 피하며, 애플리케이션의 작업 중지 및 재시도 방식을 정하세요.
다음 참고 문서