# ربط Zapier بـGenderAPI.io V2

> اربط Zapier بـGenderAPI.io V2 لسجلات Mailchimp. اختر الموصّل المناسب، وأرسل type وvalue، ثم عالج data وmeta والأرصدة والأخطاء.

Canonical HTML: https://www.genderapi.io/ar/blog/%D8%AA%D9%83%D8%A7%D9%85%D9%84-gender-api-%D9%85%D8%B9-zapier

Last reviewed: 2026-09-29

## اختر اتصال Zapier المناسب لعقد API لديك

تستدعي وصفة HTTP في هذا الدليل GenderAPI.io V2 على https://api.genderapi.io/api/v2/gender. أرسل type وvalue في جسم JSON؛ يظهر التقدير في data، بينما توجد معلومات الطلب والخصم في meta. للموصّلات الأصلية عقودها الخاصة، وهي موضّحة أدناه.

يوفّر Zapier إجراءات GenderAPI.io لتحديد الجنس من اسم أو من عنوان بريد إلكتروني. لا تذكر الصفحة العامة إصدار نقطة النهاية ولا قواعد استجابة V2. قبل تغيير الربط في الخطوات اللاحقة، تحقّق من مخرجات الإجراءات الأصلية القائمة.

يستخدم إعداد V2 أدناه Webhooks by Zapier مع طلب POST منظّم. يتطلب Webhooks by Zapier خطة Zapier مدفوعة. ويُحتسب رصيد حساب GenderAPI والمهام المستهلكة في Zapier كلٌّ على حدة.

- [تطبيق GenderAPI.io على Zapier](https://zapier.com/apps/gender-api/integrations)
- [وثائق V1 الحالية](https://www.genderapi.io/ar/api-documentation/v1)

## جهّز الحساب والسجل المصدر

يُثري هذا المثال سجلات Mailchimp انطلاقًا من عنوان البريد الإلكتروني. تحتاج إلى صلاحية الوصول إلى التطبيق المصدر والتطبيق الهدف، ومفتاح حساب GenderAPI.io، وميزات المنصة التي يستخدمها إجراء HTTP. لا يتضمن هذا الدليل بيانات اعتماد صالحة ولا حسابات مرتبطة.

يستخدم V1 وV2 مفتاح الحساب نفسه والرصيد نفسه. قبل إعداد أي طلب تُخصم عليه الأرصدة، تحقّق من المفتاح عبر GET /api/v2/usage وتأكّد من أن قيمة meta.access.mode في استجابة نقطة النهاية هذه هي api_key. إذا كان المفتاح مفقودًا أو غير معروف، فقد يُستخدم الوصول المشترك عبر التجربة حسب عنوان IP؛ ولا ينبغي أن تعتمد الأتمتة في بيئة الإنتاج على ذلك دون علمك.

أبقِ سير العمل متوقفًا أثناء إعداده. يُخصم على التقدير المُرسل للاختبار عدد الأرصدة المعتاد. راجعنا هذه الأدلة استنادًا إلى الوثائق العامة لكل منصة وإلى قواعد V2؛ ولم يُشغَّل لهذا المنشور أي سير عمل مُصادَق عليه من البداية إلى النهاية على أي منصة.

- [المصادقة والتحقق المجاني من الاستخدام](https://www.genderapi.io/ar/docs/v2/authentication#environment-setup)

## اضبط طلب GenderAPI.io V2 في Zapier

- ابدأ بمشغّل Mailchimp يوفّر سجل المشترك الصحيح. احفظ id الجمهور (Audience) وid جهة الاتصال، وأضف قبل إجراء HTTP عامل تصفية يتجاوز عناوين البريد الإلكتروني الفارغة.
- اختر Webhooks by Zapier والإجراء POST. أدخل URL الوارد أدناه واختر Payload Type: JSON. أضف حقول البيانات type = email، وvalue = عنوان البريد الإلكتروني المربوط للمشترك، وoptions__ai_mode = off.
- في Zapier يؤدي الترميز بشرطتين سفليتين إلى تضمين options__ai_mode في جسم JSON بصيغة options.ai_mode. تعرض كتلة الشيفرة أدناه الجسم الذي تتلقاه API فعليًا؛ وليست حقلًا رابعًا يُضاف إلى الإجراء.
- في قسم Headers أضف Authorization بالقيمة Bearer YOUR_API_KEY. استخدم application/json في Content-Type. لا تكتب المفتاح في حقول المشغّل أو في سلسلة الاستعلام أو في الاستجابات النموذجية.

| إعداد HTTP | القيمة | الغرض |
| --- | --- | --- |
| `Method` | `POST` | يرسل طلب تقدير واحدًا. |
| `URL` | `https://api.genderapi.io/api/v2/gender` | نقطة نهاية GenderAPI.io V2 للتقديرات الفردية. |
| `Authorization` | `Bearer YOUR_API_KEY` | استبدل هذه القيمة النائبة عبر إعدادات المصادقة أو الترويسات في المنصة. |
| `Content-Type` | `application/json` | يرسل كائنًا يتضمن كائن options متداخلًا، لا حقول نموذج. |
| `options.ai_mode` | `off` | اختبار أول مقصود يعتمد على مجموعة البيانات فقط: يُخصم رصيد واحد عادةً، حتى في النتيجة غير المعروفة. |

## راجع جسم JSON قبل الإرسال

يعرض هذا المثال إدخالًا ثابتًا، وليس نتيجة متوقعة. تحقّق أولًا من بنية الطلب، ثم استبدل value بالحقل المصدر المربوط مع تسلسل JSON صحيح. لا ترسل تعبيرات الربط الخاصة بالمنصة إلى API كنص حرفي.

لإدخالات أخرى اضبط type على name أو email أو username وضع القيمة المقابلة في value. أضف country فقط إذا كان لديك سياق موثوق؛ فهذا الحقل اختياري ولا يحدد بلد إقامة الشخص.

**طلب V2 بتنسيق JSON في Zapier**

```json
{
  "type": "email",
  "value": "alex@example.com",
  "options": {
    "ai_mode": "off"
  }
}
```

- [حقول الطلب وأنواعها وقيمها الافتراضية](https://www.genderapi.io/ar/docs/v2/request-parameters)

## تحقّق من خطوة HTTP قبل تفعيل التحديثات

ترويسات webhook ليست حقلًا مخصصًا للأسرار: فكل من يستطيع تعديل Zap يمكنه رؤيتها. قيّد الوصول، ولا تشارك Zap أو لقطات الشاشة أو ملفات التصدير التي تحتوي على بيانات الاعتماد. يوفّر Zapier أيضًا API by Zapier مع بيانات اعتماد محفوظة، لكن طريقة إعداد جسم الطلب فيه تختلف عن وصفة POST المنظّمة هذه.

لا تغلّف الجسم: أرسل كائنًا واحدًا فقط، لا قائمة ولا مصفوفة. اختر إجراء JSON المنظّم لبيانات العملاء المربوطة؛ إذ يرسل Custom Request نصًا خامًا ولا يهرّب تلقائيًا المحارف الخاصة في القيم المُدخلة.

- [طلبات webhook المنظّمة وJSON المتداخل في Zapier](https://help.zapier.com/hc/en-us/articles/8496326446989-Send-webhooks-in-Zap-workflows)
- [الاتصالات ببيانات الاعتماد في API by Zapier](https://help.zapier.com/hc/en-us/articles/44391660158733-How-to-get-started-with-API-by-Zapier)
- [سلوك الإعادة (Replay) في Zapier](https://help.zapier.com/hc/en-us/articles/19220226086797-What-is-replay)

## تعامل مع نتائج identified والنتائج غير المعروفة والأخطاء كلٌّ على حدة

حلّل جسم الاستجابة قبل اختيار أي تحديث في النظام الهدف. تشير مسارات JSON في الجدول أدناه إلى جسم استجابة V2؛ وقد تغلّفه منصتك داخل كائن آخر أو تسطّحه. تحقّق من البنية الفعلية باختبار محدود، واحفظ النتيجة مع id السجل المصدر.

لا يحدد التقدير هوية الشخص ولا الجنس الذي يصرّح به الشخص. احفظه منفصلًا عن البيانات التي يقدّمها الشخص بنفسه. حدّد معايير القبول ببيانات تمثّل حالة استخدامك، وقيّم درجة الثقة المستمدة من مجموعة البيانات ودرجة الثقة الصادرة عن الذكاء الاصطناعي كلًّا على حدة.

| التحقق | القيمة أو النوع المتوقع | القرار في سير العمل |
| --- | --- | --- |
| `meta.access.mode` | api_key لسير العمل المرتبط بالحساب | إذا كانت القيمة ip_trial، فأوقف سير العمل وأصلح المفتاح. لا تثبت الاستجابة الناجحة عبر التجربة حسب عنوان IP أن المصادقة تمت بالحساب، وقد تكون أرصدة التجربة قد استُهلكت بالفعل. |
| `meta.usage.billing_status` | confirmed أو unconfirmed | إذا كانت القيمة unconfirmed، فاحفظ id الطلب وتحقّق من حالة الخصم قبل إعادة المحاولة أو المتابعة. |
| `data.result_status / data.gender` | identified مع male أو female؛ النتيجة غير المعروفة مع null | احفظ نتائج identified المقبولة في حقل مخصص للبيانات المُستنتجة. أبقِ النتيجة غير المعروفة كما هي دون إسناد فئة افتراضية إليها. |
| `data.confidence / data.confidence_kind` | رقم من 0 إلى 1 أو null؛ نوع الدليل أو null | فسّر observed_frequency وmodel_reported كلًّا على حدة؛ ولا يضمن أيٌّ منهما دقة عامة. |
| `data.source / data.sample_count` | dataset أو ai أو none / عدد صحيح أو null | احفظ مصدر التقدير. لا يملك الذكاء الاصطناعي حجم عينة مخزّنًا، وحجم العينة في مجموعة البيانات ليس مقياسًا لدقة المنتج. |
| `meta.request_id / meta.usage` | مرجع الطلب / كائن الاستخدام | احفظ كليهما مع سجل سير العمل والنتيجة. لا تكتب مفاتيح API أو بيانات شخصية غير ضرورية في السجلات العادية. |
| `خطأ HTTP / غياب الاستجابة` | Problem Details أو استجابة غير مكتملة | أوقف التحديث وتحقّق من الخطأ ومن حالة الخصم. لا يثبت انتهاء المهلة أن الخادم لم يعالج شيئًا. |

- [المرجع الكامل لاستجابة V2](https://www.genderapi.io/ar/docs/v2/responses)
- [الأخطاء وانتهاء المهلة وقرارات إعادة المحاولة](https://www.genderapi.io/ar/docs/v2/errors-and-retries)

## حدّث السجل المطابق فقط في Mailchimp

افحص الاستجابة المُحلَّلة لإجراء الاختبار واختر الحقول الخاصة بـ data.gender وdata.result_status ومسارات V2 الأخرى الواردة أعلاه. قد يسطّح منتقي الحقول في Zapier التسميات المتداخلة: اعتمد على القيمة التي لاحظتها وعلى المسار الأب بدلًا من افتراض الحقل القديم probability في الموصّل الأصلي. حدّث فقط مشترك Mailchimp الذي حُفظ id الخاص به.

اختبر فروع النتيجة identified والنتيجة غير المعروفة والخطأ كلًّا على حدة قبل تفعيل التحديثات. تتيح لك استجابات نموذجية وهمية التحقق من شروط التفرّع دون إرسال تقدير جديد. يجب أن يعتمد التحديث في التطبيق الهدف على هذه الفحوص، وألّا يستبدل حقولًا أو وسومًا غير ذات صلة.

- [حقول الاستجابة والنتائج غير المعروفة](https://www.genderapi.io/ar/docs/v2/responses)
- [شرح الدقة ودرجة الثقة](https://www.genderapi.io/ar/accuracy-methodology)
- [مصادر البيانات وملف قاعدة البيانات المؤرَّخ](https://www.genderapi.io/ar/data-provenance)

## تحكّم في إعادة المحاولة وتكرار الخصم

قبل تفعيل Zap تحقّق في Zapier من إعدادات Autoreplay والإعادة اليدوية (Replay). إعادة تشغيل إجراء webhook فاشل ترسل طلبًا جديدًا؛ فلا تُعِد تشغيل طلب ناجح لمجرد إصلاح خطوة Mailchimp لاحقة. احفظ id المشترك الأصلي مع نتيجة الطلب.

كل طلب جديد إلى GenderAPI عملية مستقلة. أزِل أحداث المصدر المكررة في سير العمل قبل الإرسال، مستعينًا بمعرّف id المصدر المحفوظ وحالة المعالجة. ليس معرّف id لسجل المصدر مفتاحًا يمنع التكرار على الخادم.

النتيجة غير المعروفة الناجحة نتيجة مكتملة تُخصم أرصدتها. عند انتهاء المهلة أو وصول استجابة ناقصة، قد تكون النتيجة والخصم كلاهما غير معروفين: احفظ مرجع الطلب إن توفّر، وتحقّق من الخصم قبل إعادة إرسال الطلب. التزم بترويسة Retry-After عندما ترافق استجابة تجاوز حدود الطلبات.

- [الأرصدة وحالة الخصم](https://www.genderapi.io/ar/docs/v2/credits-and-usage)

## متى تستخدم الذكاء الاصطناعي

forceToGenderize اختياري للأسماء وعناوين البريد الإلكتروني وأسماء المستخدمين. عند تفعيله، احذف ai_mode أو استخدم fallback؛ فلا يمكن الجمع بينه وبين off أو always، ويعيد ذلك 422. يكفي رصيد ابتدائي موجب لبدء الطلب، حتى لو جعل الخصم النهائي الرصيد سالبًا.

قد يعيد وضع الأسماء المستعارة جنسًا مع name: null، وقد يعطي أيضًا نتيجة غير معروفة. لا يضمن الرجوع العادي إلى الذكاء الاصطناعي ولا تفسير الأسماء المستعارة إجابة صحيحة أو قيمة غير null.

| خيار الطلب | السلوك | الأرصدة لكل بحث ناجح |
| --- | --- | --- |
| options.ai_mode: off | يستخدم مجموعة البيانات فقط. | 1، حتى للنتيجة غير المعروفة |
| options.ai_mode: fallback | يبحث في مجموعة البيانات أولًا، ثم يستخدم الذكاء الاصطناعي العادي إذا لم يُعَد جنس. وهو الإعداد الافتراضي للطلبات الفردية. | 1 إجمالًا، بما في ذلك الرجوع إلى الذكاء الاصطناعي |
| options.ai_mode: always | يستخدم الذكاء الاصطناعي مباشرة. | 2 |
| forceToGenderize: true | يبحث في مجموعة البيانات أولًا، ثم يترك للذكاء الاصطناعي تفسير اسم مستعار شخصي أو كنية، حتى دون اسم أول حقيقي. | 1 للنتيجة الموجودة في مجموعة البيانات؛ و2 إجمالًا إذا استُخدم الذكاء الاصطناعي |

- [خيارات الذكاء الاصطناعي وتفسير الأسماء المستعارة](https://www.genderapi.io/ar/docs/v2/ai-options)
- [الأرصدة والاستخدام](https://www.genderapi.io/ar/docs/v2/credits-and-usage)

## تحقّق من سير العمل قبل زيادة الحجم

- تحقّق باختبار محدود من JSON المُسلسل فعليًا، ومسارات النتائج المُحلَّلة، والوصول بمفتاح API، وتأكيد الخصم. واختبر إن أمكن التعامل مع النتائج غير المعروفة والأخطاء باستجابات نموذجية.
- حدّد خطوات سير العمل التي تُكرَّر وحقول العملاء التي تتغير. احفظ id السجل المصدر والاستجابة المستلمة ومرجع الطلب، حتى لا يستلزم فشلٌ لاحق في النظام الهدف طلبًا جديدًا.
- فعّل أولًا تشغيلًا صغيرًا ومضبوطًا، وتحقّق من السجلات والأرصدة قبل زيادة التوازي. أرصدة GenderAPI ومهام أو عمليات منصة الأتمتة المحتسبة تكلفتان منفصلتان.
- للمعالجة المجمّعة استخدم POST /api/v2/gender/batch بما يصل إلى 50 عنصرًا مع الوصول بمفتاح API أو 10 عناصر في التجربة حسب عنوان IP. يمكن أن تجمع المصفوفة items بين الأسماء وعناوين البريد الإلكتروني وأسماء المستخدمين، مع خيارات صريحة وid فريد لكل عنصر. افحص كل نتيجة على حدة: فقد تتضمن استجابة HTTP 200 أخطاءً في عناصر منفردة. ويجب التحقق بشكل منفصل من دعم الموصّل الأصلي للطلب المجمّع.

- [الطلب المجمّع وأخطاء العناصر المنفردة](https://www.genderapi.io/ar/docs/v2/batch)
- [دليل التكامل مع Python](https://www.genderapi.io/ar/integrations/python)
- [دليل التكامل مع Node.js](https://www.genderapi.io/ar/integrations/javascript)

## لماذا يستخدم إعداد Zapier الحقل options__ai_mode؟

يستخدم إجراء POST المنظّم في Webhooks شرطتين سفليتين لإنشاء JSON متداخل. تتلقى API القيمة options: {ai_mode: off}، حيث off سلسلة نصية. ولا تتلقى حقلًا حرفيًا باسم options__ai_mode في المستوى الأعلى.

## هل يستخدم مثال HTTP المباشر الذكاء الاصطناعي؟

يضبط جسم الطلب الأول options.ai_mode على off. غيّر القيمة عن قصد إلى fallback لاستخدام الرجوع المعتاد إلى الذكاء الاصطناعي بتكلفة إجمالية قدرها رصيد واحد، أو إلى always لاستخدام الذكاء الاصطناعي مباشرة بتكلفة 2 رصيد. يبحث forceToGenderize في مجموعة البيانات أولًا: يكلّف رصيدًا واحدًا إذا حُلّ الطلب هناك، أو 2 رصيد إجمالًا إذا استُخدم الذكاء الاصطناعي.

## هل النتيجة غير المعروفة مجانية، وهل يمكن إعادة إرسالها تلقائيًا بأمان؟

لا. النتيجة غير المعروفة الناجحة نتيجة مكتملة تُخصم عليها الأرصدة. كل إعادة محاولة هي بحث جديد. عند حدوث خطأ في النقل أو عدم تأكيد الخصم، راجع بيانات الاستخدام المُعادة ومرجع الطلب قبل أن تقرر إعادة إرساله.

## هل شُغّل سير العمل هذا بحساب مرتبط؟

لا. رُوجعت تعليمات إعداد المنصات في 26 سبتمبر 2026 استنادًا إلى وثائقها العامة. ورُوجعت شروح طلب GenderAPI.io V2 واستجابته في 27 سبتمبر 2026. أما مراجعة هذه النسخة العربية في 29 سبتمبر 2026 فهي تدقيق للترجمة، وليست اختبارًا جديدًا بحساب. قبل تفعيل التحديثات في بيئة الإنتاج، تحقّق في حسابك من الحقول الحالية للإجراء المختار، والمصادقة، وجسم الطلب، والاستجابة، وسلوك إعادة المحاولة.

## المصادر والوثائق

- [تطبيق GenderAPI.io على Zapier](https://zapier.com/apps/gender-api/integrations)
- [طلبات webhook المنظّمة وJSON المتداخل في Zapier](https://help.zapier.com/hc/en-us/articles/8496326446989-Send-webhooks-in-Zap-workflows)
- [الاتصالات ببيانات الاعتماد في API by Zapier](https://help.zapier.com/hc/en-us/articles/44391660158733-How-to-get-started-with-API-by-Zapier)
- [سلوك الإعادة (Replay) في Zapier](https://help.zapier.com/hc/en-us/articles/19220226086797-What-is-replay)
- [قواعد طلب GenderAPI.io V2](https://www.genderapi.io/ar/docs/v2/request-parameters)
- [قواعد استجابة GenderAPI.io V2](https://www.genderapi.io/ar/docs/v2/responses)
- [الخصم والأرصدة في GenderAPI.io V2](https://www.genderapi.io/ar/docs/v2/credits-and-usage)