# وثائق GenderAPI.io V2

> اربط تطبيقك بـ GenderAPI.io V2 عبر api.genderapi.io. احصل على تقديرات من الأسماء أو عناوين البريد الإلكتروني أو أسماء المستخدمين، وعالج طلبات مجمّعة مختلطة، واقرأ النتائج مع البيانات الوصفية للوصول والخصم.

Canonical HTML: https://www.genderapi.io/ar/api-documentation

Last reviewed: 2026-09-29

## أرسل طلبك الأول

استخدم GenderAPI.io V2 لتقدير الجنس من اسم أول أو اسم كامل، أو من عنوان بريد إلكتروني، أو من اسم مستخدم. أصل API هو https://api.genderapi.io والمسار الأساسي لـ V2 هو /api/v2. جرّب مثال GET أدناه في المتصفح، ثم اختر دليلًا لربط تطبيقك.

في التجربة المجانية حسب عنوان IP، يحصل كل عنوان IP على 10 أرصدة خلال 24 ساعة، ويتشاركها V1 وV2. يستخدم هذا المثال مجموعة البيانات فقط، وتكلفته رصيد واحد لكل طلب، بما في ذلك كل إعادة تحميل للصفحة. عند استخدام مفتاح API الحالي، يستخدم V1 وV2 رصيد الحساب نفسه.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Omar&country=SA&ai_mode=off
```

- [افتح مثال GET (يستهلك رصيدًا واحدًا من التجربة حسب عنوان IP)](https://api.genderapi.io/api/v2/gender?type=name&value=Omar&country=SA&ai_mode=off)
- [إعداد مفتاح API](https://www.genderapi.io/ar/docs/v2/authentication#environment-setup)
- [فهم استجابة JSON](https://www.genderapi.io/ar/docs/v2/responses)

## ماذا تريد أن تفعل؟

اختر نوع الإدخال للحصول على أمثلة جاهزة للتشغيل في cURL وJavaScript وPython وPHP وJava وC# وGo. راجع دليلَي النتائج والخصم عندما تكون مستعدًا للتعامل مع استجابات حقيقية.

- [مفتاح API والتجربة حسب عنوان IP](https://www.genderapi.io/ar/docs/v2/authentication): اربط مفتاح API أو جرّب API مجانًا.
- [معاملات الطلب](https://www.genderapi.io/ar/docs/v2/request-parameters): اختر حقول الإدخال وسياق الدولة وخيارات الطلب.
- [حزم SDK الرسمية](https://www.genderapi.io/ar/docs/v2/sdks): ثبّت عميلًا رسميًا للغة البرمجة التي تستخدمها.
- [الجنس من الاسم](https://www.genderapi.io/ar/docs/v2/gender-from-name): ابحث عن اسم أول أو اسم كامل.
- [الجنس من عنوان البريد الإلكتروني](https://www.genderapi.io/ar/docs/v2/gender-from-email): اعثر على إشارة اسم في عنوان بريد إلكتروني.
- [الجنس من اسم المستخدم](https://www.genderapi.io/ar/docs/v2/gender-from-username): استخدم اسم مستخدم أو اسمًا مستعارًا كمُدخل.
- [الطلبات المجمّعة](https://www.genderapi.io/ar/docs/v2/batch): عالج حتى 50 اسمًا أو عنوان بريد إلكتروني أو اسم مستخدم في طلب واحد.
- [التحقق من أرقام الهواتف](https://www.genderapi.io/ar/docs/v2/phone-validation): تحقّق من رقم هاتف ونسّقه.
- [قراءة الاستجابة](https://www.genderapi.io/ar/docs/v2/responses): اقرأ التقديرات ودرجات الثقة والنتائج غير المعروفة.
- [الذكاء الاصطناعي والأسماء المستعارة](https://www.genderapi.io/ar/docs/v2/ai-options): اختر متى تستخدم الذكاء الاصطناعي وكيف تُفسَّر الأسماء المستعارة.
- [الأرصدة ورصيد الحساب](https://www.genderapi.io/ar/docs/v2/credits-and-usage): تحقّق من رصيدك ومن تكلفة كل طلب.
- [الأخطاء وإعادة المحاولة](https://www.genderapi.io/ar/docs/v2/errors-and-retries): عالج الأخطاء وقرّر متى تكون إعادة المحاولة مناسبة.
- [الترحيل من V1 إلى V2](https://www.genderapi.io/ar/docs/v2/migration): حدّث تكاملًا قائمًا باستخدام مفتاح API نفسه.

## مرجع نقاط النهاية

ادمج https://api.genderapi.io مع المسارات المطلقة في هذا الجدول، مثل https://api.genderapi.io/api/v2/gender. معاملات الاستعلام مدعومة فقط في GET /gender. استخدم جسم JSON لمسارات POST، ولا ترسل حقول V1 مثل name أو email أو username أو askToAI في طلب V2.

| الطريقة | المسار | الغرض |
| --- | --- | --- |
| GET | /api/v2 | الإمكانات العامة والحدود الحالية؛ مجاني. |
| GET | /api/v2/openapi.json | عقد OpenAPI المرجعي؛ مجاني. |
| GET | /api/v2/errors | فهرس أخطاء قابل للقراءة آليًا؛ مجاني. |
| GET | /api/v2/usage | الرصيد الحالي للحساب أو للتجربة حسب عنوان IP؛ مجاني. |
| GET / POST | /api/v2/gender | اسم واحد أو عنوان بريد إلكتروني واحد أو اسم مستخدم واحد. |
| POST | /api/v2/gender/batch | طلب مجمّع مرتّب من الأسماء و/أو عناوين البريد الإلكتروني و/أو أسماء المستخدمين. |
| POST | /api/v2/phone/validate | التحقق من صحة رقم هاتف وتنسيقه. |