لماذا Webhook
الاستعلام المتكرر من API يعمل، لكن Webhook يوصل كل رسالة SMS خلال ثوانٍ دون أن تسأل شيفرتك مرارًا وتكرارًا.
الإعداد
افتح صفحة مفتاح API، وأدخل عنوان HTTPS على نطاق عام واحفظ. يُعرض سر التوقيع مرة واحدة فقط: احفظه مع الأسرار الأخرى لخادمك.
ما الذي تستلمه
طلب POST بمحتوى JSON: الحدث sms.received وdata تتضمن معرّف الإيجار، ورقم الهاتف، والمرسل، والنص الكامل، والرمز المكتشف، ووقت الاستلام.
تحقّق من كل طلب
اقرأ الترويسة X-PortSMS-Signature، واحسب HMAC-SHA256 لـ "t.body" باستخدام السر، وقارنه مع v1 بمقارنة ثابتة الزمن. ارفض الطلبات التي يزيد عمر t فيها على 5 دقائق.
أجب بسرعة
أرسل حالة 2xx بمجرد تخزين الرسالة، وأنجز الأعمال البطيئة بعد ذلك. أي رد آخر يُعاد إرساله حتى 8 مرات.