التكاملات وواجهة 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 يخص بوابة الدفع ولا يمكن تعيينه.
الاستجابة
| الحقل | المعنى |
|---|---|
| ok | true عند النجاح. |
| order_id | الطلب الذي حدّثته. |
| previous_status | ما كان عليه الطلب قبل ذلك. |
| status | الحالة التي صار عليها. |
| changed | true إذا تغيّرت الحالة. وfalse إذا كانت للطلب أصلًا، وفي هذه الحالة لا يُكتب شيء. |
ويرسل التغيير الناجح أيضًا حدث order.status_updated إلى webhook الخاص بك، فيراه نظام ثانٍ مثل جهاز لوحي. ولا يفشل تغييرك أبدًا بسبب تعطل نقطة webhook لديك.
الأخطاء
| الحالة | `error` | المعنى |
|---|---|---|
| 400 | missing_status, unsupported_status, invalid_json, missing_order_id | المحتوى غير صالح، أو الحالة ليست ضمن القائمة المسموحة. |
| 401 | missing_api_key, invalid_api_key | لا مفتاح، أو مفتاح خاطئ أو ملغى. |
| 403 | scope_denied | لا يملك المفتاح صلاحية Orders. |
| 404 | order_not_found | لا طلب بهذا المعرّف في حسابك. |
| 429 | rate_limited | طلبات كثيرة في هذه الدقيقة. |
| 503 | lookup_failed, update_failed | تعذّر على Menuthere قراءة الطلب أو كتابته. حاول مرة أخرى. |
أسئلة
ماذا يحدث إذا أعادت نقطة بيعي المحاولة بعد انتهاء المهلة؟
لا ضرر. إذا كانت للطلب هذه الحالة أصلًا يعيد الاستدعاء changed: false ولا يكتب شيئًا.
هل يصل العميل رسالة عندما أغيّر الحالة؟
يمر الطلب عبر حالاته المعتادة، فتعمل المسارات التي تنطلق عند تلك الحالات. راجع تحديثات الطلبات للعملاء.
ذات صلة
لم تجد ما تبحث عنه؟ راسلنا على [email protected] أو تحدّث معنا من 9 صباحًا حتى 9 مساءً.مركز المساعدةالأسعارmenuthere.com