# الترحيل من GenderAPI v1 إلى v2

> انقل تكامل GenderAPI من الإصدار 1 إلى الإصدار 2 باستخدام نفس مفتاح وتوازن API. حقول طلب الخريطة، والمسارات المجمعة، والاستجابات، والأخطاء، وسلوك إعادة المحاولة.

Canonical HTML: https://www.genderapi.io/ar/docs/v2/migration

Last reviewed: 2026-09-25

## نقل التكامل من الإصدار 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 | كل إعادة محاولة هي عملية جديدة بفواتير عادية |

- [اقرأ مرجع الإصدار الأول](https://www.genderapi.io/ar/api-documentation/v1)
- [استخدم عقد OpenAPI v2](https://api.genderapi.io/api/v2/openapi.json)

## قم بتحديث عميلك والتحقق منه

استخدم عقد الطلب والاستجابة v2 للتكامل الذي تقوم بترحيله. تحقق من meta.access.mode واحتفظ بنتائج JSON null وافحص أخطاء الدُفعة لكل عنصر وتحقق من الفواتير قبل إعادة المحاولة. احتفظ بعمليات تكامل الإصدار الأول على مساراتهم الحالية حتى يتم تحديث عملائهم.

- [ابدأ بالمصادقة](https://www.genderapi.io/ar/docs/v2/authentication)
- [اقرأ رد الإصدار الثاني](https://www.genderapi.io/ar/docs/v2/responses)
- [التعامل مع إعادة المحاولة](https://www.genderapi.io/ar/docs/v2/errors-and-retries)