Entegrasyonu V1’den V2’ye taşıma
V1 kullanılabilir kalır. Hazır olduğunuzda entegrasyonları aynı anahtar ve bakiyeyle tek tek taşıyın. V2’nin istek ve yanıt sözleşmesi farklıdır; yalnızca URL’yi değiştirmek yetmez.
| GenderAPI.io V1 | GenderAPI.io V2 |
|---|---|
| /api, /api/email, /api/username | POST /api/v2/gender; type: name, email veya username ve value kullanın. |
| /api/name/multi/country, /api/email/multi/country, /api/username/multi/country | POST /api/v2/gender/batch; items içinde farklı girdi türleri birlikte gönderilebilir. |
| /api/phone; number ve address | POST /api/v2/phone/validate; number ve country gönderin, data.valid ve data.possible alanlarını okuyun. |
| askToAI | options.ai_mode: fallback; tekli sorgularda zaten varsayılandır |
| forceToGenderize | Üç türde aynı isteğe bağlı alan; önce veri kümesi, sonra takma ad odaklı yapay zekâ |
| Düz yanıt alanları | Sonuç için data; erişim ve ücretlendirme için meta |
| Yüzdelik probability | 0–1 ölçeğinde confidence ve confidence_kind; yapay zekâ skorları kalibre edilmiş olasılık değildir |
| total_names | data.sample_count; null olabilir |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| Eski hata biçimi | HTTP durumu ile Problem Details code ve action |
| POST yeniden denemeleri | Her yeniden deneme normal ücretlendirilen yeni işlemdir |
İstemcinizi güncelleyin ve doğrulayın
Taşıdığınız entegrasyonda V2 istek ve yanıt sözleşmesini uygulayın. meta.access.mode alanını doğrulayın, JSON null sonuçlarını koruyun, toplu öğe hatalarını inceleyin ve yeniden denemeden önce ücretlendirmeyi kontrol edin. İstemcileri güncellenene kadar V1 entegrasyonlarını mevcut yollarında tutun.