نقل تكامل من V1 إلى V2
يظل GenderAPI.io V1 متاحًا. انقل كل تكامل إلى V2 باستخدام مفتاح API والرصيد نفسيهما. لـ V2 عقد طلب واستجابة مختلف، لذا لا يكفي تغيير عنوان URL: حدّث المسارات وحقول الطلب ومعالجة الاستجابات معًا. يستخدم V2 الكائن data للنتائج والكائن meta لمعلومات الطلب والوصول والخصم.
| 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 | POST /api/v2/gender/batch مع items؛ ويمكن الجمع بين أنواع الإدخال المختلفة. |
| /api/phone مع number وaddress | POST /api/v2/phone/validate مع number وcountry؛ اقرأ data.valid وdata.possible. |
| askToAI | options.ai_mode: fallback؛ تستخدم الطلبات الفردية fallback افتراضيًا |
| forceToGenderize | الحقل الاختياري نفسه للأنواع الثلاثة؛ مجموعة البيانات أولًا، ثم الذكاء الاصطناعي الذي يفسّر الأسماء المستعارة |
| حقول استجابة غير متداخلة | data للنتيجة؛ وmeta للوصول والخصم |
| probability كنسبة مئوية | confidence على مقياس من 0 إلى 1 مع confidence_kind؛ وقيم الذكاء الاصطناعي ليست احتمالات معايرة |
| total_names | data.sample_count، ويمكن أن يكون null |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| تنسيق الأخطاء القديم | حالة HTTP مع code وaction من Problem Details |
| إعادة محاولة طلبات POST | كل إعادة محاولة عملية جديدة تُخصم أرصدتها كالمعتاد |
تحديث العميل والتحقق منه
استخدم عقد الطلب والاستجابة في V2 للتكامل الذي تنقله. تحقّق من meta.access.mode، واحتفظ بنتائج JSON null، وافحص أخطاء العناصر المنفردة في الطلبات المجمّعة، وتحقّق من الخصم قبل إعادة المحاولة. أبقِ تكاملات V1 على مساراتها الحالية حتى تُحدَّث برامج العميل الخاصة بها.