توثيق API

ادمج فحص أرقام الهاتف خلال دقائق

الرابط الأساسي

https://api.zelnum.com/api/v1

نطاق الـ API منفصل عمدًا عن نطاق لوحة التحكم، ليتم توسيع الـ API وحمايته بشكل مستقل. ولهذا تستخدم الأمثلة هنا api.zelnum.com بينما لوحتك على app.zelnum.com.

المصادقة

تتطلب جميع نقاط النهاية مفتاح API داخل ترويسة الطلب.

تنسيق الاستجابة

تعيد جميع نقاط النهاية JSON.

سير العمل المعتاد

جلب الرصيد — GET /v1/balance
إرسال فحص (أرقام) — POST /v1/detect · POST /v1/detect/file
جلب حالة المهمة — GET /v1/tasks/{token}
جلب رابط التنزيل — GET /v1/tasks/{token}/result · GET /v1/tasks/{token}/download

فحص رقم واحد لحظيًا

الـ SDK الرسمي

تُغلّف مكتبة Python نقاط النهاية في هذه الصفحة: استجابات مُعرّفة الأنواع، ومفاتيح Idempotency، وتنزيل نتائج الفحص بالجملة. وهي حالياً الـ SDK الوحيد المدعوم رسميًا — أما بقية اللغات فتستدعي واجهة REST مباشرة.

Python — https://github.com/Zelnum/zelnum-python · https://pypi.org/project/zelnum/