اختر اتصال Make المناسب لعقد API لديك
تستدعي وصفة HTTP في هذا الدليل GenderAPI.io V2 على https://api.genderapi.io/api/v2/gender. أرسل type وvalue في جسم JSON؛ يظهر التقدير في data، بينما توجد معلومات الطلب والخصم في meta. للموصّلات الأصلية عقودها الخاصة، وهي موضّحة أدناه.
يوفّر Make تطبيق GenderAPI.io بإجراءات للأسماء وعناوين البريد الإلكتروني. تشير الصفحة العامة إلى genderapi.io، لكنها لا تذكر الإصدار الدقيق لنقطة النهاية ولا البنية الكاملة للاستجابة. قبل تغيير الربط في سيناريو قائم، تحقّق من المخرجات الفعلية للوحدة المختارة.
للحصول على سلوك V2 صريح، استخدم تطبيق HTTP في Make مع الطلب أدناه. لا يحدّث إعداد HTTP هذا أي وحدة GenderAPI قائمة؛ لذا دع السيناريوهات العاملة تستمر بشكل منفصل إلى أن يُتحقَّق من البديل.
جهّز الحساب والسجل المصدر
يُثري هذا المثال سجلات Shopify انطلاقًا من عنوان البريد الإلكتروني. تحتاج إلى صلاحية الوصول إلى التطبيق المصدر والتطبيق الهدف، ومفتاح حساب GenderAPI.io، وميزات المنصة التي يستخدمها إجراء HTTP. لا يتضمن هذا الدليل بيانات اعتماد صالحة ولا حسابات مرتبطة.
يستخدم V1 وV2 مفتاح الحساب نفسه والرصيد نفسه. قبل إعداد أي طلب تُخصم عليه الأرصدة، تحقّق من المفتاح عبر GET /api/v2/usage وتأكّد من أن قيمة meta.access.mode في استجابة نقطة النهاية هذه هي api_key. إذا كان المفتاح مفقودًا أو غير معروف، فقد يُستخدم الوصول المشترك عبر التجربة حسب عنوان IP؛ ولا ينبغي أن تعتمد الأتمتة في بيئة الإنتاج على ذلك دون علمك.
أبقِ سير العمل متوقفًا أثناء إعداده. يُخصم على التقدير المُرسل للاختبار عدد الأرصدة المعتاد. راجعنا هذه الأدلة استنادًا إلى الوثائق العامة لكل منصة وإلى قواعد V2؛ ولم يُشغَّل لهذا المنشور أي سير عمل مُصادَق عليه من البداية إلى النهاية على أي منصة.
اضبط طلب GenderAPI.io V2 في Make
- اختر مشغّل عملاء Shopify مناسبًا للسيناريو الخاص بك وحمّل سجل اختبار ممثِّلًا. احفظ id العميل للتحديث النهائي، وتجاوز السجلات التي يكون فيها عنوان البريد الإلكتروني فارغًا.
- أضف HTTP > Make a request. في تطبيق HTTP الحالي اختر مصادقة API key وأنشئ بيانات اعتماد: قيمة المفتاح Bearer YOUR_API_KEY، والموضع Header، واسم المعامل Authorization. استخدم طريقة إدارة بيانات الاعتماد هذه بدلًا من كتابة المفتاح في URL.
- اضبط الطريقة على POST وأدخل URL الوارد أدناه. اختر application/json لجسم الطلب، واستخدم بنية بيانات تضم حقلي النص type وvalue ومجموعة options تحتوي على حقل النص ai_mode. اضبط type على email وai_mode على off، ثم اربط عنوان البريد الإلكتروني للعميل بـ value.
- فعّل Parse response. الجسم المُنشأ ببنية بيانات في Make يُسلسل القيم المربوطة بصيغة 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 قبل تفعيل التحديثات
أبقِ إعادة التوجيه معطّلة لهذه الوجهة الثابتة عبر HTTPS لواجهة API. إذا غيّرت إصدار تطبيق HTTP في Make، فراجع إعدادات المصادقة وجسم الطلب مجددًا، لأن عناصر التحكم قد تختلف.
شغّل اختبارًا محدودًا، وافحص الحزمة (bundle) التي تحتوي على الاستجابة المُحلَّلة، وأنشئ مسارات منفصلة لنتائج identified المقبولة والنتائج غير المعروفة وأخطاء التشغيل قبل إضافة تحديث العميل.
تعامل مع نتائج 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 أو استجابة غير مكتملة | أوقف التحديث وتحقّق من الخطأ ومن حالة الخصم. لا يثبت انتهاء المهلة أن الخادم لم يعالج شيئًا. |
حدّث السجل المطابق فقط في Shopify
اربط مسارات جسم V2 الواردة أعلاه في استجابة HTTP المُحلَّلة. قد يضع Make الجسم تحت تسمية مخرجات للوحدة: اختر الكائنين المتداخلين data وmeta من الحزمة التي فحصتها. حدّث فقط العميل الذي حُفظ id الخاص به من المشغّل، واكتب النتيجة في حقل مخصص للبيانات المُستنتجة أو وفق سياسة محددة للوسوم.
اختبر فروع النتيجة identified والنتيجة غير المعروفة والخطأ كلًّا على حدة قبل تفعيل التحديثات. تتيح لك استجابات نموذجية وهمية التحقق من شروط التفرّع دون إرسال تقدير جديد. يجب أن يعتمد التحديث في التطبيق الهدف على هذه الفحوص، وألّا يستبدل حقولًا أو وسومًا غير ذات صلة.
تحكّم في إعادة المحاولة وتكرار الخصم
تحقّق من معالجات الأخطاء في Make ومن إعدادات عمليات التنفيذ غير المكتملة. قد تُعاد محاولة بعض الأخطاء المؤقتة حتى دون إعداد صريح لإعادة المحاولة. قد ترسل إعادة المحاولة في وحدة HTTP طلبًا إضافيًا تُخصم عليه الأرصدة. إذا نجح الطلب وفشل تحديث Shopify اللاحق، فاستخدم المخرجات المحفوظة لإصلاح ذلك التحديث.
كل طلب جديد إلى 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 أخطاءً في عناصر منفردة. ويجب التحقق بشكل منفصل من دعم الموصّل الأصلي للطلب المجمّع.
الأسئلة الشائعة
هل يجب أن أضع مفتاح API في URL داخل Make؟
لا. في إعداد HTTP الخاص بـ V2 احفظ Bearer YOUR_API_KEY في بيانات اعتماد من نوع API key، بحيث يكون الموضع Header واسم المعامل Authorization. لا تقبل نقطة النهاية POST معامل استعلام باسم key.
هل يستخدم مثال HTTP المباشر الذكاء الاصطناعي؟
يضبط جسم الطلب الأول options.ai_mode على off. غيّر القيمة عن قصد إلى fallback لاستخدام الرجوع المعتاد إلى الذكاء الاصطناعي بتكلفة إجمالية قدرها رصيد واحد، أو إلى always لاستخدام الذكاء الاصطناعي مباشرة بتكلفة 2 رصيد. يبحث forceToGenderize في مجموعة البيانات أولًا: يكلّف رصيدًا واحدًا إذا حُلّ الطلب هناك، أو 2 رصيد إجمالًا إذا استُخدم الذكاء الاصطناعي.
هل النتيجة غير المعروفة مجانية، وهل يمكن إعادة إرسالها تلقائيًا بأمان؟
لا. النتيجة غير المعروفة الناجحة نتيجة مكتملة تُخصم عليها الأرصدة. كل إعادة محاولة هي بحث جديد. عند حدوث خطأ في النقل أو عدم تأكيد الخصم، راجع بيانات الاستخدام المُعادة ومرجع الطلب قبل أن تقرر إعادة إرساله.
هل شُغّل سير العمل هذا بحساب مرتبط؟
لا. رُوجعت تعليمات إعداد المنصات في 26 سبتمبر 2026 استنادًا إلى وثائقها العامة. ورُوجعت شروح طلب GenderAPI.io V2 واستجابته في 27 سبتمبر 2026. أما مراجعة هذه النسخة العربية في 29 سبتمبر 2026 فهي تدقيق للترجمة، وليست اختبارًا جديدًا بحساب. قبل تفعيل التحديثات في بيئة الإنتاج، تحقّق في حسابك من الحقول الحالية للإجراء المختار، والمصادقة، وجسم الطلب، والاستجابة، وسلوك إعادة المحاولة.
المصادر والوثائق
رُوجعت النسخة العربية آخر مرة في . تستند معلومات المنصات إلى وثائقها العامة التي رُوجعت في 26 سبتمبر 2026، ولا تُعد هذه المراجعة اختبارًا جديدًا بحساب مرتبط. تحقّق من الإعداد الحالي ومن التوفر في الوثائق الرسمية للمنصة.