V1에서 V2로 연동 옮기기
V1은 계속 사용할 수 있습니다. 준비가 되면 같은 키와 크레딧 잔액으로 연동을 하나씩 이전하세요. V2는 요청 및 응답 규격이 다르므로 URL만 바꾸는 것으로는 충분하지 않습니다.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender. type에 name, email 또는 username을 지정하고 value를 보냅니다. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | items를 지정한 POST /api/v2/gender/batch. 여러 입력 유형을 섞을 수 있습니다. |
| number와 address를 지정한 /api/phone | number와 country를 지정한 POST /api/v2/phone/validate. data.valid와 data.possible을 확인합니다. |
| askToAI | options.ai_mode: fallback. 단일 요청의 기본값은 이미 fallback입니다. |
| forceToGenderize | 세 가지 유형 모두에 같은 선택 필드를 사용하며, 먼저 데이터셋을 조회한 다음 별명을 해석하는 AI를 사용합니다. |
| 평면 구조의 응답 필드 | 결과는 data, 접근과 과금 정보는 meta |
| 백분율 단위의 probability | 0~1 척도의 confidence와 confidence_kind. AI 점수는 보정된 확률이 아닙니다. |
| total_names | data.sample_count(null 가능) |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| 기존 오류 형식 | HTTP 상태와 Problem Details의 code 및 action |
| POST 재시도 | 각 재시도는 일반 과금이 적용되는 새 작업입니다. |
클라이언트 업데이트 및 확인
이전하려는 연동에는 V2 요청 및 응답 규격을 사용하세요. meta.access.mode를 확인하고, JSON null 결과를 그대로 유지하고, 일괄 요청의 항목별 오류를 확인하고, 재시도하기 전에 과금을 확인하세요. V1 연동은 클라이언트를 업데이트할 때까지 기존 경로를 그대로 사용하세요.