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

واجهة API العامة: نظرة عامة والمفاتيح

تتيح لك واجهة Menuthere API أن تتحكم نقطة البيع أو برنامجك الخاص بمتجرك. ينشئ دعم Menuthere لك مفتاحًا بصلاحية Orders أو WhatsApp أو كليهما، ويستدعي برنامجك نقاط النهاية به. ولا يستطيع المفتاح أبدًا أن يرى أو يغيّر إلا بياناتك.

المكان
Ask Menuthere support for a key
الباقة
لا تقفل لوحة التحكم مفاتيح API بحسب الباقة. أما إرسال قوالب واتساب فيحتاج أيضًا إلى رقم واتساب مربوط، وهو يبدأ من Starter / Pro.
المدة
5 دقائق
آخر تحديث

أنشئ المفاتيح وأدِرها

الخطوة 1: اطلب مفتاحًا من دعم Menuthere

مفاتيح API غير موجودة في لوحة التحكم بعد، لذلك ينشئها دعم Menuthere. أخبر الدعم بما سيُستخدم له المفتاح، مثل “Billing POS”.

الخطوة 2: اختر صلاحيته

يستطيع المفتاح ذو صلاحية Orders تحديث حالة طلباتك. وذو صلاحية WhatsApp يستطيع إرسال قوالب واتساب. اطلب فقط ما يحتاجه برنامجك.

الخطوة 3: احفظ المفتاح فورًا

يظهر المفتاح مرة واحدة عند إنشائه. ولا يحتفظ Menuthere إلا ببصمة له، فلا يمكن عرضه مجددًا. ضعه في إعدادات برنامجك فورًا. وإن فقدته فاطلب من الدعم إلغاءه وإنشاء مفتاح آخر.

استخدام المفتاح

أرسل المفتاح بصيغة Authorization: Bearer ck_live_… من خادمك. لا تضعه أبدًا في صفحة متصفح أو تطبيق جوال، لأن كل من يقرؤه يستطيع تغيير طلباتك. مثال من سطر واحد:

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}/statusOrdersAPI: تحديث حالة طلب
GET /api/v1/whatsapp/templatesWhatsAppAPI: عرض قوالب واتساب وإرسالها
POST /api/v1/whatsapp/send-templateWhatsAppAPI: عرض قوالب واتساب وإرسالها
الحالةالخطأالمعنى
401missing_api_key, invalid_api_keyلم يُرسل مفتاح، أو المفتاح خاطئ أو ملغى.
403scope_deniedلا يملك المفتاح الصلاحية التي تحتاجها نقطة النهاية.
429rate_limitedطلبات كثيرة في هذه الدقيقة. الحد الافتراضي لكل مفتاح 120 في الدقيقة.
من الجيد أن تعرفيمكنك امتلاك حتى 10 مفاتيح نشطة. اطلب من دعم Menuthere إلغاء مفتاح لم تعد تستخدمه. فيتوقف كل ما يستخدمه فورًا، ولا يمكن استعادة مفتاح ملغى.

أسئلة

هل يستطيع مفتاح رؤية طلبات مطعم آخر؟
لا. كل مفتاح يخص مطعمًا واحدًا. ويُفحص كل طلب مقابل ذلك المطعم، فيُبلَّغ عن طلب من حساب آخر بأنه غير موجود.
فقدت مفتاحي. هل تعرضونه مرة أخرى؟
لا. لا تُخزَّن إلا بصمة. اطلب من دعم Menuthere إلغاء المفتاح القديم وإنشاء جديد، ثم حدّث برنامجك.

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