التقنية المالية
خطوط التحقق من الهوية
تستدعي خدمات KYC والإلحاق هذه الواجهة من داخل مسار التحقق لتأكيد أن الصورة على وثيقة الهوية تطابق الشخص ذاته في أماكن أخرى على الويب العام.
FaceSearch REST API
شغّل بحث الوجوه من أي لغة
يمنح REST API الخاص بـ FaceSearch المطوّرين سطحاً صغيراً ومستقراً للبحث العكسي عن صور الوجوه: أرسل الصورة، استعلم عن الحالة، واقرأ النتائج.
آلاف عمليات البحث
متاح في جميع أنحاء العالم
تشفير 256 بت
دقة مطابقة عالية
يمنح REST API الخاص بـ FaceSearch المطوّرين سطحاً صغيراً ومستقراً للبحث العكسي عن صور الوجوه: أرسل الصورة، استعلم عن الحالة، واقرأ النتائج.
- بماذا تبحث
- صورة واحدة تحتوي على وجه. لا يوجد بحث بالكلمات المفتاحية.
- ما الذي تحصل عليه
- صفحات مرتّبة يظهر فيها وجه مطابق، ولكل نتيجة درجة ثقة ورابط للمصدر.
- كيف يتحدد التطابق
- التعرف على الوجوه. يُحوَّل الوجه إلى متجه تضمين — سلسلة من الأرقام — ثم يُقارَن بالمسافة، لا باسم الملف أو التعليق أو البكسل. كيف يعمل التعرف على الوجوه؟
- تكلفة البحث الواحد
- 3 أرصدة. تبدأ الحسابات الجديدة بـ 3 أرصدة مجانية دون الحاجة إلى بطاقة ائتمان.
- مدة الاحتفاظ بالصور
- تُحذف الصور المرفوعة خلال 24 ساعة من انتهاء البحث.
كيف يعمل REST API
ثلاث خطوات من طرفية فارغة إلى أول نتيجة بحث.
أنشئ مفتاح API
سجّل الدخول إلى لوحة التحكم وأنشئ مفتاحاً. يظهر النص الصريح مرة واحدة فقط. احفظه في مدير الأسرار لديك ولا تُودعه أبداً في الشيفرة المصدرية.
أرسل صورتك عبر POST
شغّل curl -F [email protected] https://facesearch.net/api/v1/search مع ترويسة Bearer. تُعيد نقطة النهاية jobId خلال أقل من ثانية.
استعلم حتى الاكتمال
نفّذ GET /api/v1/search/{jobId} كل 3 إلى 5 ثوانٍ. عندما تصبح الحالة completed، تتضمن الاستجابة عناوين المصادر المطابقة والصور المصغّرة ودرجات الثقة.
مزايا REST API
كل ما تحتاج إليه لدمج بحث الوجوه في خلفية إنتاجية.
مواصفات OpenAPI 3.1
مستند OpenAPI مكتوب يدوياً على /api/v1/openapi.json يُغذّي كل SDK ذي أنواع آمنة، من استيراد Postman إلى عملاء مُولَّدين في أكثر من 20 لغة.
محاولات إعادة مُتعادلة
أرسل ترويسة Idempotency-Key وفق RFC 9110 ويُعيد الخادم نفس jobId للطلبات المكررة. إذا أغفلتها، يشتق الخادم تلقائياً هاشاً لمحتوى الصورة، فتبقى إعادات المحاولة البسيطة آمنة دائماً.
حصص لكل مفتاح
يمكن لكل مفتاح API أن يحمل سقفاً يومياً وشهرياً اختيارياً. لا يمكن لمفتاح مسرَّب أن يستنزف رصيدك كاملاً، لأن الحصة تُطبَّق بسرعة Redis مع احتياطي في Postgres.
حدود معدل دقيقة
تحمل كل استجابة ترويستَي X-RateLimit-Remaining وX-RateLimit-Reset. وتتضمن استجابات 429 ترويسة Retry-After لتعرف بدقة متى يمكنك إعادة المحاولة.
مجمع رصيد مشترك
يُخصم استهلاك API من نفس رصيد الرصيد الذي تستخدمه الواجهة عبر الويب. يكفي تعبئة واحدة في لوحة التحكم لتشغيل السطحين معاً، دون إدارة منتج فوترة جديد.
أخطاء قابلة للتنبؤ
كل استجابة خطأ هي مغلَّف ثابت: code وmessage وstatus. لا تتغير أكواد مثل INSUFFICIENT_CREDITS وRATE_LIMITED أبداً، فيمكن لمعالج الأخطاء لديك أن يبقى بسيطاً وطويل الأمد.
انسخ. الصق. أطلق.
كل استدعاء لواجهة FaceSearch API هو طلب HTTP واحد. إليك نفس سير «إرسال بحث عن وجه» بخمس لغات.
سطر واحد في الطرفية
# 1. Submit a face image for search
curl -X POST https://facesearch.net/api/v1/search \
-H "Authorization: Bearer fs_live_YOUR_KEY" \
-H "Idempotency-Key: submit-$(date +%s)" \
-F "image=@/path/to/face.jpg" \
-F "consent=true"
# 2. Poll for completion
curl https://facesearch.net/api/v1/search/JOB_ID \
-H "Authorization: Bearer fs_live_YOUR_KEY"
# 3. Check your credit balance
curl https://facesearch.net/api/v1/credits \
-H "Authorization: Bearer fs_live_YOUR_KEY"من يبني فوق REST API
من فحوص الخلفية إلى أدوات الأمان، تدعم هذه الواجهة فرقاً تحتاج إلى بحث الوجوه على نطاق واسع.
الأمان
الإشراف الآلي
تربط فرق الثقة والأمان الواجهة بمسار الاستجابة للحوادث، لتثرى البلاغات المُصعَّدة بالسياق خلال ثوانٍ لا ساعات.
أبحاث
الأبحاث الاستقصائية
يكتب الصحفيون الاستقصائيون وباحثو OSINT سكربتات بحث جماعية من دفاتر Jupyter، مستخدمين ترويسة مفتاح التعادل لإزالة التكرار في دفعات الليل.
الآلاف يثقون بالبحث عن الوجه
10 ميغابايت
الحد الأقصى لحجم الرفع
صور JPEG أو PNG أو WebP
24 ساعة
مدة الاحتفاظ بالصور
تُحذف الملفات المرفوعة تلقائيًا
24/7
توفر البحث
ابحث في أي وقت ومن أي مكان
3
رصيد لكل بحث
أسعار بسيطة وشفافة
ما يقوله المطوّرون عن الواجهة
ملاحظات حقيقية من فرق تدمج FaceSearch في مسارات الإنتاج.
“سياسة مفتاح التعادل الهجينة هي الأفضل التي رأيتها في أي واجهة. تعمل إعادات المحاولة البسيطة دون عناء، والمفاتيح الصريحة تمنحنا تحكماً كاملاً عندما نحتاج إلى عمليات بحث جديدة فعلاً.”
“ربطنا FaceSearch بخط الإشراف لدينا خلال ظهيرة واحدة. حصص المفاتيح تتيح لنا تسليم فرق مختلفة مفاتيحها الخاصة دون القلق من أن يستنزف أحدهم المجمّع بالخطأ.”
“أتاحت لي مواصفات OpenAPI توليد عميل Python بأنواع مكتوبة بأمر واحد. لا تتبدل أكواد الأخطاء، فظل خط معالجتي مملّاً بمعناه الإيجابي منذ شهور.”
تسعير بسيط وشفاف
اختر الخطة التي تناسب احتياجاتك. لا رسوم خفية، إلغاء في أي وقت.
الأكثر شيوعاً
PRO
$29/شهر
للمحترفين والمستخدمين المتقدمين
- 60 أرصدة شهرياً ($0.48 لكل رصيد)
- البحث عن الوجوه
- سجل البحث
- إمكانية تصدير الملف الشخصي إلى PDF
أو اشترِ باقات أرصدة
ادفع حسب الاستخدام
Starter
3أرصدة
$6
$2.00/رصيد
وفّر 20%
Basic
30أرصدة
$24
$0.80/رصيد
وفّر 31%
Standard
100أرصدة
$69
$0.69/رصيد
وفّر 34%
Pro
300أرصدة
$199
$0.66/رصيد
وفّر 40%
Enterprise
1000أرصدة
$599
$0.60/رصيد
الأسئلة الشائعة حول REST API
كل ما يسأل عنه المطوّرون قبل كتابة أول طلب.
ابدأ البناء مع REST API
أنشئ مفتاح API مجانياً، والصق أمر curl السطري، ونفّذ أول بحث لك في أقل من عشر دقائق.
إنشاء مفتاح API
لا حاجة لبطاقة ائتمان
