الواجهة البرمجية لـWataDish
تربط المطاعم على خطتي Pro وBusiness أنظمتها الخاصة بطلباتها وقائمتها وحجوزات طاولاتها على WataDish. أنشئ مفتاحاً في لوحة الإدارة تحت «الواجهة البرمجية»، وأرسله كرمز Bearer.
curl https://watadish.com/api/v1/orders?status=open \
-H "Authorization: Bearer wdk_…"
JSON في الإرسال والاستلام، UTF-8، حتى 120 طلباً في الدقيقة لكل مفتاح. الخطأ يكون {"error": {"code": "…", "message": "…"}}: 401 unauthorized، 403 not_in_plan، 404 not_found، 409 not_allowed، 422 bad_request أو bad_status، 429 too_many.
الطلبات
GET /orders?status=open|all&since=2026-10-18T00:00:00Z&limit=50- طلباتك، الأحدث أولاً (open: تلك قيد المعالجة)، كلٌّ برمزه ورقمه ونوعه وحالته وبنوده وخياراته، والمجاميع بالوحدات الصغرى، والعملة، والدفع، والزبون، والتوصيل، والأوقات، والسجل.
GET /orders/{code}- طلب واحد.
POST /orders/{code}/status {"status": "accepted", "eta": 20}- حرّك طلباً كما تفعل لوحة الإدارة: accepted (مع eta بالدقائق)، preparing، ready، out_for_delivery، completed، rejected أو cancelled (مع سبب). طلب البطاقة المرفوض أو الملغى يُستردّ كما في لوحة الإدارة، ويُبلَّغ الزبائن كالمعتاد.
القائمة
GET /menu- الأقسام والأطباق والخيارات والأسعار، بكل لغات القائمة.
POST /items/{id}/availability {"available": false}- طبق نفد، أو عاد.
الحجوزات
GET /bookings?from=2026-10-18- حجوزات طاولاتك من يوم ما فصاعداً: الرمز والحالة والوقت وعدد الأشخاص والاسم والهاتف والبريد والملاحظات.
Webhook
حدّد عنوان https في لوحة الإدارة. ترسل WataDish إليه كل حدث كـJSON: order.created وorder.updated وbooking.created وbooking.updated، وping من زر التجربة.
POST https://your.example/hook
X-WataDish-Event: order.created
X-WataDish-Timestamp: 1760787600
X-WataDish-Signature: sha256=…
{"event": "order.created", "sent_at": "…", "order": {…}} للتأكد من أنه جاء من WataDish، احسب HMAC-SHA256 للطابع الزمني ونقطة والمحتوى، بسرّ التوقيع الخاص بك، وقارنه بالتوقيع؛ وارفض أي طابع زمني عمره أكثر من خمس دقائق. أجب بـ2xx خلال ثلاث ثوانٍ.
بيانات الزبائن
تعرض الواجهة البرمجية رقم الزبون وبريده وعنوانه كما تعرضها لوحة الإدارة: كاملة على الطلب قيد المعالجة وليوم بعده، وبعد ذلك فقط للزبائن الذين وافقوا على عروضك. احفظ مفاتيحك وسرّك بأمان، واستخدم ما تقرؤه فقط لإدارة مطعمك.