इंटीग्रेशन को 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 इंटीग्रेशन को उनके मौजूदा पाथ पर तब तक रहने दें जब तक उनके क्लाइंट अपडेट न हो जाएँ।