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.
| V1 kavramı | V2 karşılığı |
|---|---|
| İsim, e-posta ve kullanıcı adı için ayrı uç noktalar | type ve value ile POST /api/v2/gender |
| Ayrı toplu sorgu uç noktaları | items ile POST /api/v2/gender/batch |
| 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â puanları 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.