اختر اتصال Pipedream المناسب لعقد API لديك
تستدعي وصفة HTTP في هذا الدليل GenderAPI.io V2 على https://api.genderapi.io/api/v2/gender. أرسل type وvalue في جسم JSON؛ يظهر التقدير في data، بينما توجد معلومات الطلب والخصم في meta. للموصّلات الأصلية عقودها الخاصة، وهي موضّحة أدناه.
يستخدم مكوّن GenderAPI.io العام في Pipedream، الذي رُوجع في 26 سبتمبر 2026، العنوان الأساسي القديم https://api.genderapi.io/api، ويرسل name أو email وcountry الاختياري ومفتاح API كمعاملات في سلسلة الاستعلام. التنفيذ المنشور موصّل V1، وليس نقطة نهاية JSON في V2.
يمكنك الإبقاء على الإجراء الأصلي القائم بقواعده الخاصة، أو إضافة خطوة HTTP عامة لـ V2. لا تفترض أن المصادقة التلقائية للحساب المرتبط عبر التطبيق الأصلي تناسب طلب V2 المنفصل هذا: فالوصفة تستخدم صراحةً ترويسة Bearer.
جهّز الحساب والسجل المصدر
يُثري هذا المثال سجلات Twilio SendGrid انطلاقًا من عنوان البريد الإلكتروني. تحتاج إلى صلاحية الوصول إلى التطبيق المصدر والتطبيق الهدف، ومفتاح حساب GenderAPI.io، وميزات المنصة التي يستخدمها إجراء HTTP. لا يتضمن هذا الدليل بيانات اعتماد صالحة ولا حسابات مرتبطة.
يستخدم V1 وV2 مفتاح الحساب نفسه والرصيد نفسه. قبل إعداد أي طلب تُخصم عليه الأرصدة، تحقّق من المفتاح عبر GET /api/v2/usage وتأكّد من أن قيمة meta.access.mode في استجابة نقطة النهاية هذه هي api_key. إذا كان المفتاح مفقودًا أو غير معروف، فقد يُستخدم الوصول المشترك عبر التجربة حسب عنوان IP؛ ولا ينبغي أن تعتمد الأتمتة في بيئة الإنتاج على ذلك دون علمك.
أبقِ سير العمل متوقفًا أثناء إعداده. يُخصم على التقدير المُرسل للاختبار عدد الأرصدة المعتاد. راجعنا هذه الأدلة استنادًا إلى الوثائق العامة لكل منصة وإلى قواعد V2؛ ولم يُشغَّل لهذا المنشور أي سير عمل مُصادَق عليه من البداية إلى النهاية على أي منصة.
اضبط طلب GenderAPI.io V2 في Pipedream
- اختر حدثًا في Twilio SendGrid أو جدولًا زمنيًا يناسب حسابك وسير عملك. تحقّق من جهة اتصال للاختبار، واحفظ id الثابت لها، وتجاوز عناوين البريد الإلكتروني الفارغة قبل خطوة الإثراء. الفاصل الزمني المتاح للمشغّل إعداد خاص بالمنصة، وليس التزامًا من GenderAPI.
- أضف الإجراء Send any HTTP Request، واختر POST، وأدخل URL الوارد أدناه. اضبط جسم JSON على type = email، وvalue = عنوان البريد الإلكتروني لجهة الاتصال، وoptions.ai_mode = off.
- احفظ المفتاح باستخدام عناصر التحكم في بيانات الاعتماد أو متغيرات البيئة في Pipedream. اضبط Authorization على Bearer متبوعًا بالقيمة السرية، وContent-Type على application/json. لا تواصل استخدام المصادقة الأصلية التي تضع المفتاح في سلسلة الاستعلام، ولا تُظهر المفتاح في أي خطوة.
- أنشئ الجسم ككائن JSON باستخدام عناصر التحكم في الربط التي يدعمها الإجراء. لا تبنِ JSON خامًا بدمج قيم جهة الاتصال دون تهريب المحارف الخاصة. راجع معاينة الطلب قبل تشغيل اختبار محدود.
| إعداد 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 فقط إذا كان لديك سياق موثوق؛ فهذا الحقل اختياري ولا يحدد بلد إقامة الشخص.
{
"type": "email",
"value": "alex@example.com",
"options": {
"ai_mode": "off"
}
}تحقّق من خطوة HTTP قبل تفعيل التحديثات
افحص الاستجابة المُصدَّرة من خطوة HTTP وحدّد الجسم المُحلَّل. إذا أعاد الإجراء المختار الجسم كنص، فحلّله مرة واحدة قبل قراءة data وmeta. الحقل data في غلاف النقل يختلف عن الحقل data في جسم V2.
لسير عمل قائم على الشيفرة مع تحكم صريح في انتهاء المهلة وإعادة التوجيه وإعادة المحاولة، استخدم دليل Node.js المُختبَر المذكور أدناه. قد تختلف إعدادات النقل الافتراضية بين الإجراء العام والتطبيق الأصلي.
تعامل مع نتائج 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 أو استجابة غير مكتملة | أوقف التحديث وتحقّق من الخطأ ومن حالة الخصم. لا يثبت انتهاء المهلة أن الخادم لم يعالج شيئًا. |
حدّث السجل المطابق فقط في Twilio SendGrid
احفظ id جهة الاتصال الذي أعاده المشغّل مع جسم V2 المُحلَّل. حدّث في SendGrid الحقول المخصّصة المقررة فقط بعد اجتياز فحوصات النتائج الموضحة أعلاه. أبقِ الاسم الذي قدّمته جهة الاتصال: فقيمة data.name المستخلصة من عنوان البريد الإلكتروني اسم مرشّح مُستنتج، وليست بديلًا مُتحقَّقًا منه.
اختبر فروع النتيجة identified والنتيجة غير المعروفة والخطأ كلًّا على حدة قبل تفعيل التحديثات. تتيح لك استجابات نموذجية وهمية التحقق من شروط التفرّع دون إرسال تقدير جديد. يجب أن يعتمد التحديث في التطبيق الهدف على هذه الفحوص، وألّا يستبدل حقولًا أو وسومًا غير ذات صلة.
تحكّم في إعادة المحاولة وتكرار الخصم
توثّق Pipedream إعادة محاولة تلقائية تعتمد على الخطة، تبدأ من الخطوة الفاشلة. تحقّق من هذه الإعدادات ومن سلوك إعادة المحاولة في إجراء HTTP المختار. قد تؤدي إعادة المحاولة في خطوة إثراء فاشلة إلى تكاليف جديدة؛ أما الفشل اللاحق في النظام الهدف فيُصلَح باستخدام المخرجات المحفوظة لخطوة الإثراء.
كل طلب جديد إلى GenderAPI عملية مستقلة. أزِل أحداث المصدر المكررة في سير العمل قبل الإرسال، مستعينًا بمعرّف id المصدر المحفوظ وحالة المعالجة. ليس معرّف id لسجل المصدر مفتاحًا يمنع التكرار على الخادم.
النتيجة غير المعروفة الناجحة نتيجة مكتملة تُخصم أرصدتها. عند انتهاء المهلة أو وصول استجابة ناقصة، قد تكون النتيجة والخصم كلاهما غير معروفين: احفظ مرجع الطلب إن توفّر، وتحقّق من الخصم قبل إعادة إرسال الطلب. التزم بترويسة Retry-After عندما ترافق استجابة تجاوز حدود الطلبات.
متى تستخدم الذكاء الاصطناعي
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 إجمالًا إذا استُخدم الذكاء الاصطناعي |
تحقّق من سير العمل قبل زيادة الحجم
- تحقّق باختبار محدود من JSON المُسلسل فعليًا، ومسارات النتائج المُحلَّلة، والوصول بمفتاح API، وتأكيد الخصم. واختبر إن أمكن التعامل مع النتائج غير المعروفة والأخطاء باستجابات نموذجية.
- حدّد خطوات سير العمل التي تُكرَّر وحقول العملاء التي تتغير. احفظ id السجل المصدر والاستجابة المستلمة ومرجع الطلب، حتى لا يستلزم فشلٌ لاحق في النظام الهدف طلبًا جديدًا.
- فعّل أولًا تشغيلًا صغيرًا ومضبوطًا، وتحقّق من السجلات والأرصدة قبل زيادة التوازي. أرصدة GenderAPI ومهام أو عمليات منصة الأتمتة المحتسبة تكلفتان منفصلتان.
- للمعالجة المجمّعة استخدم POST /api/v2/gender/batch بما يصل إلى 50 عنصرًا مع الوصول بمفتاح API أو 10 عناصر في التجربة حسب عنوان IP. يمكن أن تجمع المصفوفة items بين الأسماء وعناوين البريد الإلكتروني وأسماء المستخدمين، مع خيارات صريحة وid فريد لكل عنصر. افحص كل نتيجة على حدة: فقد تتضمن استجابة HTTP 200 أخطاءً في عناصر منفردة. ويجب التحقق بشكل منفصل من دعم الموصّل الأصلي للطلب المجمّع.
الأسئلة الشائعة
هل يستخدم إجراء GenderAPI.io الأصلي في Pipedream الإصدار V2؟
المكوّن العام الذي رُوجع في 26 سبتمبر 2026 يستخدم نقاط النهاية القديمة في V1 والمصادقة بالمفتاح في سلسلة الاستعلام. لإرسال طلب V2 استخدم وصفة HTTP الصريحة الخاصة بـ V2، وأعد التحقق من المكوّن المنشور إذا تغيّر إصداره.
هل يستخدم مثال HTTP المباشر الذكاء الاصطناعي؟
يضبط جسم الطلب الأول options.ai_mode على off. غيّر القيمة عن قصد إلى fallback لاستخدام الرجوع المعتاد إلى الذكاء الاصطناعي بتكلفة إجمالية قدرها رصيد واحد، أو إلى always لاستخدام الذكاء الاصطناعي مباشرة بتكلفة 2 رصيد. يبحث forceToGenderize في مجموعة البيانات أولًا: يكلّف رصيدًا واحدًا إذا حُلّ الطلب هناك، أو 2 رصيد إجمالًا إذا استُخدم الذكاء الاصطناعي.
هل النتيجة غير المعروفة مجانية، وهل يمكن إعادة إرسالها تلقائيًا بأمان؟
لا. النتيجة غير المعروفة الناجحة نتيجة مكتملة تُخصم عليها الأرصدة. كل إعادة محاولة هي بحث جديد. عند حدوث خطأ في النقل أو عدم تأكيد الخصم، راجع بيانات الاستخدام المُعادة ومرجع الطلب قبل أن تقرر إعادة إرساله.
هل شُغّل سير العمل هذا بحساب مرتبط؟
لا. رُوجعت تعليمات إعداد المنصات في 26 سبتمبر 2026 استنادًا إلى وثائقها العامة. ورُوجعت شروح طلب GenderAPI.io V2 واستجابته في 27 سبتمبر 2026. أما مراجعة هذه النسخة العربية في 29 سبتمبر 2026 فهي تدقيق للترجمة، وليست اختبارًا جديدًا بحساب. قبل تفعيل التحديثات في بيئة الإنتاج، تحقّق في حسابك من الحقول الحالية للإجراء المختار، والمصادقة، وجسم الطلب، والاستجابة، وسلوك إعادة المحاولة.
المصادر والوثائق
رُوجعت النسخة العربية آخر مرة في . تستند معلومات المنصات إلى وثائقها العامة التي رُوجعت في 26 سبتمبر 2026، ولا تُعد هذه المراجعة اختبارًا جديدًا بحساب مرتبط. تحقّق من الإعداد الحالي ومن التوفر في الوثائق الرسمية للمنصة.