خصم 50% بالرمز BLACKFRIDAY50خصم 20% بالرمز BLACKFRIDAY20
التكاملات وواجهة APIكل الباقات

API: تحديث حالة طلب

يتيح POST /api/v1/orders/{order_id}/status لنقطة بيعك أن تخبر Menuthere متى قبل المطبخ الطلب ومتى خرج. ويحتاج إلى مفتاح بصلاحية Orders. وإرسال حالة يملكها الطلب أصلًا لا يغيّر شيئًا، فإعادة المحاولة آمنة.

المكان
Ask Menuthere support for a key
الباقة
لا تقفل لوحة التحكم هذا بحسب الباقة.
آخر تحديث

الطلب

curl -X POST 'https://menuthere.com/api/v1/orders/ORDER_ID/status' -H 'Authorization: Bearer ck_live_YOUR_KEY' -H 'Content-Type: application/json' -d '{"status":"accepted"}'

الجزءالقيمة
الطريقة والمسارPOST /api/v1/orders/{order_id}/status
الترويسةAuthorization: Bearer ck_live_…، من مفتاح بصلاحية Orders
المحتوىJSON: { "status": "accepted" }
order_idمعرّف الطلب. يصلك بصيغة data.order_id في webhook الطلبات.
قيم status المسموحةaccepted, food_ready, dispatched, in_transit, completed
من الجيد أن تعرفالإلغاء غير متاح هنا. فالإلغاء يردّ نقاط الولاء ويعيد المخزون ويستدعي إلغاء أي شريك توصيل، لذلك يبقى في لوحة التحكم. راجع إلغاء طلب. كما أن pending_payment يخص بوابة الدفع ولا يمكن تعيينه.

الاستجابة

الحقلالمعنى
oktrue عند النجاح.
order_idالطلب الذي حدّثته.
previous_statusما كان عليه الطلب قبل ذلك.
statusالحالة التي صار عليها.
changedtrue إذا تغيّرت الحالة. وfalse إذا كانت للطلب أصلًا، وفي هذه الحالة لا يُكتب شيء.

ويرسل التغيير الناجح أيضًا حدث order.status_updated إلى webhook الخاص بك، فيراه نظام ثانٍ مثل جهاز لوحي. ولا يفشل تغييرك أبدًا بسبب تعطل نقطة webhook لديك.

الأخطاء

الحالة`error`المعنى
400missing_status, unsupported_status, invalid_json, missing_order_idالمحتوى غير صالح، أو الحالة ليست ضمن القائمة المسموحة.
401missing_api_key, invalid_api_keyلا مفتاح، أو مفتاح خاطئ أو ملغى.
403scope_deniedلا يملك المفتاح صلاحية Orders.
404order_not_foundلا طلب بهذا المعرّف في حسابك.
429rate_limitedطلبات كثيرة في هذه الدقيقة.
503lookup_failed, update_failedتعذّر على Menuthere قراءة الطلب أو كتابته. حاول مرة أخرى.

أسئلة

ماذا يحدث إذا أعادت نقطة بيعي المحاولة بعد انتهاء المهلة؟
لا ضرر. إذا كانت للطلب هذه الحالة أصلًا يعيد الاستدعاء changed: false ولا يكتب شيئًا.
هل يصل العميل رسالة عندما أغيّر الحالة؟
يمر الطلب عبر حالاته المعتادة، فتعمل المسارات التي تنطلق عند تلك الحالات. راجع تحديثات الطلبات للعملاء.

لم تجد ما تبحث عنه؟ راسلنا على help@mail.menuthere.com أو تحدّث معنا من 9 صباحًا حتى 9 مساءً.مركز المساعدةالأسعارmenuthere.com