RESALAHUB

تكامل API مع Node.js وPython وPHP

اربط رسالة هب بعميل HTTP الذي تستخدمه. استخدم واجهة JSON الموثّقة نفسها من Node.js أوPython أوPHP أو أي بيئة خادم تدعم HTTPS.

تحدث معنااستكشف الواجهة البرمجية

استخدم أدوات HTTP في لغتك

لا توجد حزمة SDK رسمية منشورة لرسالة هب. لا تحتاج إلى @outbox/sdk أو@resalahub/sdk. استخدم fetch في Node.js أوrequests في Python أوcURL في PHP وأرسل مفتاح Bearer من خادمك.

بنية طلب موحّدة

اجلب GET /v1/sms/phones واستخدم معرّف الهاتف المُعاد في phoneId، وليس رقم الشريحة. أرسل to وtext إلى POST /v1/sms. ينشئ الخادم معرّف الطلب تلقائيًا. احفظ id المُعاد لمتابعة الحالة لاحقًا.

تعامل مع إعادة المحاولة بعناية

إذا احتجت إلى منع تكرار الطلب، أنشئ UUID في requestId قبل الإرسال وأعد استخدامه للرسالة نفسها فقط. دون requestId ينشئ كل إرسال طلبًا جديدًا. لا تكرر إرسال واتساب غير المؤكد تلقائيًا؛ راجع السجل أولًا.

const response = await fetch(process.env.RESALAHUB_URL + "/v1/sms", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RESALAHUB_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    phoneId: "YOUR_PHONE_ID",
    to: "+966502214471", text: "Your booking is confirmed."
  })
});
const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result));
console.log(result.id);

استكشف المزيد

واجهة الرسائل النصيةواجهة واتسابتواصل معنا