API दस्तावेज़ीकरण V2

GenderAPI v1 से v2 पर माइग्रेट करें

समान API कुंजी और संतुलन का उपयोग करके GenderAPI एकीकरण को v1 से v2 पर ले जाएं। मानचित्र अनुरोध फ़ील्ड, बैच मार्ग, प्रतिक्रियाएँ, त्रुटियाँ और पुनः प्रयास व्यवहार।

एकीकरण को v1 से v2 पर ले जाएँ

V1 उपलब्ध रहता है. तैयार होने पर एक ही कुंजी और क्रेडिट बैलेंस का उपयोग करके व्यक्तिगत एकीकरण को माइग्रेट करें। V2 एक अलग अनुरोध और प्रतिक्रिया अनुबंध है, इसलिए केवल URL बदलना पर्याप्त नहीं है।

V1 अवधारणाV2 समतुल्य
अलग नाम, ईमेल और उपयोगकर्ता नाम समापन बिंदुPOST /api/v2/gender type और value के साथ
एकाधिक समापन बिंदुओं को अलग करेंPOST /api/v2/gender/batch items के साथ
askToAIoptions.ai_mode: fallback; एकल अनुरोध पहले से ही fallback पर डिफ़ॉल्ट हैं
forceToGenderizeतीनों प्रकारों के लिए समान वैकल्पिक फ़ील्ड; पहले डेटासेट, फिर उपनाम-जागरूक AI
समतल प्रतिक्रिया फ़ील्डपरिणाम के लिए data; पहुंच और बिलिंग के लिए meta
probability प्रतिशत0-1 पैमाने पर confidence प्लस confidence_kind; एआई स्कोर कैलिब्रेटेड संभावनाएं नहीं हैं
total_namesdata.sample_count, अशक्त
used_credits / remaining_creditsmeta.usage.charged_credits / remaining_credits
लीगेसी त्रुटि प्रारूपHTTP स्थिति प्लस Problem Details code और action
POST पुनः प्रयास करेंप्रत्येक पुनः प्रयास सामान्य बिलिंग के साथ एक नया ऑपरेशन है

अपने ग्राहक को अद्यतन और सत्यापित करें

आप जिस एकीकरण को स्थानांतरित कर रहे हैं उसके लिए v2 अनुरोध और प्रतिक्रिया अनुबंध का उपयोग करें। meta.access.mode को सत्यापित करें, JSON null परिणामों को संरक्षित करें, प्रति-आइटम बैच त्रुटियों का निरीक्षण करें और पुनः प्रयास करने से पहले बिलिंग की जांच करें। जब तक उनके क्लाइंट अपडेट नहीं हो जाते, तब तक उनके मौजूदा पथों पर v1 एकीकरण रखें।