الويب هوك والـAPI
اربط المطعم ببقية أنظمتك
اشترك بعنوان HTTPS في الأحداث التي تهمك. كل تسليم موقّع ومسجّل ويُعاد عند الفشل، فيثق به نظامك وترى ما حدث.
الويب هوك
يضيف المطعم عنوانًا من لوحة التحكم ويختار أحداثه، ويرسل ريسترو إليه JSON لحظة حدوثها.
الأحداث
| order.created | طلب جديد من أي قناة |
|---|---|
| order.status_changed | انتقل طلب إلى حالة جديدة |
| order.completed | اكتمل طلب |
| order.cancelled | أُلغي طلب |
| payment.captured | تم تحصيل دفعة |
| payment.refunded | استُردت دفعة |
| reservation.created | حُجزت طاولة |
| reservation.cancelled | أُلغي حجز |
| customer.created | سجل عميل جديد |
| review.created | ترك عميل تقييمًا |
| inventory.low_stock | وصل صنف مخزون إلى حد إعادة الطلب |
| subscription.updated | تغيّرت باقة المطعم |
موقّع، ومسجّل، ويُعاد
التوقيع
X-Restro-Signature: t=<ثوانٍ يونكس>,v1=<HMAC-SHA256 لـ«t.body»> بسرّ العنوان الخاص بك. ارفض كل ما لا يتطابق.
الترويسات
X-Restro-Event يسمّي الحدث وX-Restro-Delivery يعرّف التسليم، فتتعرف على إعادة المحاولة.
إعادة المحاولة والسجل
التسليم الفاشل يُعاد بفواصل متزايدة حتى ست محاولات، وكل محاولة ظاهرة في سجل التسليم في اللوحة.
عناوين آمنة
يجب أن تكون العناوين HTTPS عامة؛ ولا تُتبع إعادات التوجيه، فلا يمكن تحويل التسليم إلى عنوان داخلي.
الـAPI
مفاتيح API للمطورين (rtd_…) تحمل صلاحيات صريحة — اليوم صلاحيات منصة الثيمات: themes:read وthemes:submit وthemes:withdraw. وواجهة REST تحت /api/v1 هي التي تستخدمها لوحة التحكم والكاشير وتطبيق المالك؛ والوصول إلى الـAPI وحصة الطلبات اليومية من ميزات الباقات.
تحتاج وصولًا أوسع للـAPI من أجل ربط — محاسبة، أو تطبيق توصيل، أو مزوّد ولاء؟ أخبرنا بما تربطه وسنعمل عليه معك.
ضع كل شيء على نظام واحد
ابدأ على الباقة المجانية وجرّبه بقائمتك أنت — ومعه الكاشير الذي يبيع دون إنترنت. لا شيء تلغيه إن لم يناسبك.
- بلا بطاقة بنكية
- عربي وإنجليزي مدمجان
- يبيع دون إنترنت في كل الباقات