Skip to main content
FaceSearch REST API

شغّل بحث الوجوه من أي لغة

يمنح REST API الخاص بـ FaceSearch المطوّرين سطحاً صغيراً ومستقراً للبحث العكسي عن صور الوجوه: أرسل الصورة، استعلم عن الحالة، واقرأ النتائج. مصادقة Bearer، محاولات إعادة مُتعادلة، ومواصفات OpenAPI متاحة للعموم.

نقطة نهاية واحدة • 3 رصيد لكل عملية بحث • JSON في كل مكان

موثوق به من الآلاف حول العالم

+15,000 عملية بحث
+50 دولة
تشفير 256 بت
99.7% دقة

كيف يعمل REST API

ثلاث خطوات من طرفية فارغة إلى أول نتيجة بحث.

أنشئ مفتاح API
1

أنشئ مفتاح API

سجّل الدخول إلى لوحة التحكم وأنشئ مفتاحاً. يظهر النص الصريح مرة واحدة فقط. احفظه في مدير الأسرار لديك ولا تُودعه أبداً في الشيفرة المصدرية.

أرسل صورتك عبر POST
2

أرسل صورتك عبر POST

شغّل curl -F [email protected] https://facesearch.net/api/v1/search مع ترويسة Bearer. تُعيد نقطة النهاية jobId خلال أقل من ثانية.

استعلم حتى الاكتمال
3

استعلم حتى الاكتمال

نفّذ GET /api/v1/search/{jobId} كل 3 إلى 5 ثوانٍ. عندما تصبح الحالة completed، تتضمن الاستجابة عناوين المصادر المطابقة والصور المصغّرة ودرجات الثقة.

مزايا REST API

كل ما تحتاج إليه لدمج بحث الوجوه في خلفية إنتاجية.

REST API face search features visualization

مواصفات 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

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

مهندس خلفية يدمج واجهة FaceSearch
التقنية المالية

خطوط التحقق من الهوية

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

محلل ثقة وأمان يُشغّل فحوص وجه آلية
الأمان

الإشراف الآلي

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

باحث يُشغّل عمليات بحث وجوه مجمّعة من دفتر ملاحظات
أبحاث

الأبحاث الاستقصائية

يكتب الصحفيون الاستقصائيون وباحثو OSINT سكربتات بحث جماعية من دفاتر Jupyter، مستخدمين ترويسة مفتاح التعادل لإزالة التكرار في دفعات الليل.

الآلاف يثقون بالبحث عن الوجه

+10M
بحث مكتمل
نتائج جديرة بالثقة عالمياً
95%
دقة المطابقة
مدعوم بالذكاء الاصطناعي المتقدم
+50K
مستخدم نشط
مجتمع متنامي
+100M
مصدر تم مسحه
تغطية شاملة

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

ملاحظات حقيقية من فرق تدمج FaceSearch في مسارات الإنتاج.

"سياسة مفتاح التعادل الهجينة هي الأفضل التي رأيتها في أي واجهة. تعمل إعادات المحاولة البسيطة دون عناء، والمفاتيح الصريحة تمنحنا تحكماً كاملاً عندما نحتاج إلى عمليات بحث جديدة فعلاً."
بريا ر.
مهندسة أولى، شركة ناشئة في التقنية المالية
"ربطنا FaceSearch بخط الإشراف لدينا خلال ظهيرة واحدة. حصص المفاتيح تتيح لنا تسليم فرق مختلفة مفاتيحها الخاصة دون القلق من أن يستنزف أحدهم المجمّع بالخطأ."
ماركوس ت.
قائد فريق الثقة والأمان
"أتاحت لي مواصفات OpenAPI توليد عميل Python بأنواع مكتوبة بأمر واحد. لا تتبدل أكواد الأخطاء، فظل خط معالجتي مملّاً بمعناه الإيجابي منذ شهور."
يوكي ه.
مهندسة أبحاث

تسعير بسيط وشفاف

اختر الخطة التي تناسب احتياجاتك. لا رسوم خفية، إلغاء في أي وقت.

FREE

$0/شهر

مثالي للبدء

الأكثر شيوعاً

PRO

$29/شهر

للمحترفين والمستخدمين المتقدمين

  • 100 Credits per month ($0.29 per credit)
  • Face Search
  • Search History
  • Can Export Profile to PDF
ادفع حسب الاستخدام

أو اشترِ باقات أرصدة

Starter

3أرصدة

$6

$2.00/credit

وفّر 20%

Basic

30أرصدة

$24

$0.80/credit

وفّر 31%

Standard

100أرصدة

$69

$0.69/credit

وفّر 34%

Pro

300أرصدة

$199

$0.66/credit

وفّر 40%

Enterprise

1000أرصدة

$599

$0.60/credit

الأسئلة الشائعة حول REST API

كل ما يسأل عنه المطوّرون قبل كتابة أول طلب.

ابدأ البناء مع REST API

أنشئ مفتاح API مجانياً، والصق أمر curl السطري، ونفّذ أول بحث لك في أقل من عشر دقائق.

إنشاء مفتاح API

No credit card required