نقل التكامل من الإصدار 1 إلى الإصدار 2
يظل الإصدار 1 متاحًا. قم بترحيل عمليات التكامل الفردية عندما تكون جاهزة باستخدام نفس المفتاح والرصيد الدائن. V2 هو عقد طلب واستجابة مختلف، لذا فإن تغيير عنوان URL فقط ليس كافيًا.
| مفهوم V1 | ما يعادل V2 |
|---|---|
| نقاط نهاية منفصلة للاسم والبريد الإلكتروني واسم المستخدم | POST /api/v2/gender مع type وvalue |
| نقاط نهاية متعددة منفصلة | POST /api/v2/gender/batch مع items |
| askToAI | options.ai_mode: fallback؛ الطلبات الفردية افتراضية بالفعل على fallback |
| forceToGenderize | نفس الحقل الاختياري لجميع الأنواع الثلاثة؛ مجموعة البيانات أولاً، ثم الذكاء الاصطناعي المدرك للاسم المستعار |
| حقول الاستجابة الثابتة | data للنتيجة؛ meta للوصول والفواتير |
| نسبة probability | confidence على مقياس من 0 إلى 1 بالإضافة إلى confidence_kind؛ لا يتم معايرة درجات الذكاء الاصطناعي |
| total_names | data.sample_count، لاغية |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| تنسيق خطأ قديم | حالة HTTP بالإضافة إلى Problem Details code وaction |
| إعادة المحاولة POST | كل إعادة محاولة هي عملية جديدة بفواتير عادية |
قم بتحديث عميلك والتحقق منه
استخدم عقد الطلب والاستجابة v2 للتكامل الذي تقوم بترحيله. تحقق من meta.access.mode واحتفظ بنتائج JSON null وافحص أخطاء الدُفعة لكل عنصر وتحقق من الفواتير قبل إعادة المحاولة. احتفظ بعمليات تكامل الإصدار الأول على مساراتهم الحالية حتى يتم تحديث عملائهم.