v1에서 v2로 통합 이동
V1은 계속 사용 가능합니다. 준비가 되면 동일한 키 및 크레딧 잔액을 사용하여 개별 통합을 마이그레이션하세요. V2는 요청과 응답 계약이 다르기 때문에 URL만 변경하는 것만으로는 충분하지 않습니다.
| V1 컨셉 | V2 상당 |
|---|---|
| 별도의 이름, 이메일 및 사용자 이름 엔드포인트 | POST /api/v2/gender(type 및 value 포함) |
| 여러 엔드포인트 분리 | POST /api/v2/gender/batch 및 items |
| 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 통합을 유지합니다.