انتقل إلى المحتوى الرئيسي

Zayloft developer platform

ادمج الاتصالات والمصادقة في منتجاتك عبر واجهات API واضحة وأحداث متوقعة وبنية مناسبة لأحمال إنتاج بالغة الأهمية.

استخدم REST لسير التطبيقات وSMPP 3.4 لاتصال SMS المؤسسي المناسب وwebhooks موقعة لمزامنة المراسلة والوارد والتحقق.

دعم المطورين استكشف المنصة

منصة مطور تتكامل مع الأنظمة التي تشغلها بالفعل.

استخدم REST لسير التطبيقات وSMPP 3.4 عندما يكون معدل SMS المستمر والاتصال بطابع الاتصالات مناسباً، وwebhooks لمزامنة التسليم والرسائل الواردة والتحقق.

واجهات REST

JSON بإصدارات عبر HTTPS للمراسلة والتحقق وجهات الاتصال والقوالب وwebhooks والاستخدام والحساب.

  • مسارات موارد بإصدارات
  • مصادقة Bearer
  • طلبات كتابة idempotent
  • أخطاء منظمة

SMPP 3.4

اتصال SMS للمؤسسات للأحمال التي تستفيد من جلسات مستمرة وضبط throughput وإيصالات التسليم.

  • Binds من نوع transceiver وtransmitter وreceiver
  • سير submit_sm وdeliver_sm
  • إيصالات التسليم وحالات الرسائل
  • ضبط الاتصال ومعدل الإرسال

Webhooks والأحداث

استقبل أحداثاً غير متزامنة للتسليم والوارد والتحقق والحساب وسير العمل.

  • Payloads موقعة
  • أحداث التسليم والوارد
  • معالجة آمنة مع إعادة المحاولة
  • معرفات أحداث لمنع التكرار

المصادقة وبيانات الاعتماد

استخدم بيانات اعتماد محدودة حسب البيئة وأقل قدر من الصلاحيات.

  • بيانات اعتماد محددة النطاق
  • فصل test وlive
  • تدوير المفاتيح
  • حفظ الأسرار على الخادم

صمم طلبات آمنة لإعادة المحاولة.

أعطال الشبكة والمهلات طبيعية. استخدم idempotency ومعرفات ثابتة وحالات واضحة للاسترداد دون تكرار الإجراءات.

Idempotency

أرفق مفتاحاً فريداً بعمليات الكتابة المؤهلة للتعرف على إعادة المحاولة.

Correlation

استخدم معرفات ثابتة لتتبع العمل بين نظامك وZayloft والأحداث.

Timeouts

تعامل مع المهلة كنتيجة غير معروفة حتى يتم حل الحالة بأمان.

Reconciliation

طابق الأحداث غير المتزامنة مع سجلاتك باستخدام معرفات دائمة.

سطح API واضح لفرق التطبيقات.

تستخدم الأمثلة متغير بيئة لعنوان API الأساسي.

طلب نموذجي
curl "$ZAYLOFT_API_BASE/v1/messages" \
  -H "Authorization: Bearer $ZAYLOFT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 8f36c1f0-8e7d-4d9d-a342-7aef0c2d45c2" \
  -d '{
    "channel": "sms",
    "to": "+14155550123",
    "message": "Your verification code is 482731"
  }'

احتفظ ببيانات الاعتماد على الخادم. لا تضع الأسرار في JavaScript العام أو المستودعات أو تطبيقات العميل.

أحداث واضحة. تصحيح أفضل.

لا ينبغي للتطبيق استنتاج الحالة من استجابة متزامنة واحدة.

Accepted

تم قبول طلب صالح للمعالجة.

Sent

تقدمت الرسالة عبر مسار التسليم المهيأ.

Delivered

تم استلام تأكيد تسليم عندما توفره القناة.

Failed

تعذر إكمال العملية مع سبب منظم.

Inbound

رسالة أو حدث قادم من العميل متاح للتطبيق.

Verified

اكتمل سير التحقق بنجاح.

موارد للمراجعة والتكامل والعمليات.

ابدأ بواجهة التكامل المطلوبة ثم توسع إلى العقود والبيئات والسجلات وفحص webhooks ورؤية الاستخدام.

عقود OpenAPI

تعريفات قابلة للقراءة آلياً للتوثيق والتحقق وتوليد SDK.

بيئات اختبار

افصل بيانات الاعتماد والبيانات والسلوك بين الاختبار والإنتاج.

سجلات الطلبات

تتبع معرفات الطلب والحالات والبيانات المهمة دون كشف البنية الخاصة.

فحص webhooks

راجع المحاولات والمعرفات والتوقيعات وسجل retries.

رؤية الاستخدام

تابع نشاط API والحجم والاستهلاك حسب المؤسسة والمشروع.

وعي حالة الخدمة

ادمج معلومات الصحة مع أنماط المرونة في التطبيق.

الأمان جزء من تصميم التكامل.

احتفظ بالأسرار على الخادم وتحقق من webhooks واعزل المؤسسات والبيئات وقلل نطاق الصلاحيات وسجل الأحداث المهمة.

عزل الأسرار

احفظ مفاتيح API وبيانات SMPP وأسرار webhook في إعداد محمي.

التحقق من webhooks

تحقق من التوقيع قبل الوثوق في الحدث.

أقل صلاحية

امنح فقط النطاقات والمشاريع والبيئات المطلوبة.

حدود المؤسسات

اعزل بيانات المؤسسة والمشروع طوال المعالجة.

قابلية التدقيق

سجل أحداث الإدارة وبيانات الاعتماد المهمة.

حماية النقل

استخدم TLS حديثاً وقنوات آمنة للاتصالات المستمرة.

الأسئلة الشائعة

أنشئ بنية اتصالات يمكن لتطبيقك فهم حالتها.

استخدم طلبات متوقعة وبيانات اعتماد محدودة وأحداثاً غير متزامنة ورؤية تشغيلية.

دعم المطورين إنشاء حساب

لاستفسارات API أو SMPP أو webhooks أو التكامل التقني، تواصل عبر support@zayloft.com.