واجهة API العامة: نظرة عامة والمفاتيح
تتيح لك واجهة Menuthere API أن تتحكم نقطة البيع أو برنامجك الخاص بمتجرك. ينشئ دعم Menuthere لك مفتاحًا بصلاحية Orders أو WhatsApp أو كليهما، ويستدعي برنامجك نقاط النهاية به. ولا يستطيع المفتاح أبدًا أن يرى أو يغيّر إلا بياناتك.
- المكان
- Ask Menuthere support for a key
- الباقة
- لا تقفل لوحة التحكم مفاتيح API بحسب الباقة. أما إرسال قوالب واتساب فيحتاج أيضًا إلى رقم واتساب مربوط، وهو يبدأ من 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}/status | Orders | API: تحديث حالة طلب |
| GET /api/v1/whatsapp/templates | API: عرض قوالب واتساب وإرسالها | |
| POST /api/v1/whatsapp/send-template | API: عرض قوالب واتساب وإرسالها |
| الحالة | الخطأ | المعنى |
|---|---|---|
| 401 | missing_api_key, invalid_api_key | لم يُرسل مفتاح، أو المفتاح خاطئ أو ملغى. |
| 403 | scope_denied | لا يملك المفتاح الصلاحية التي تحتاجها نقطة النهاية. |
| 429 | rate_limited | طلبات كثيرة في هذه الدقيقة. الحد الافتراضي لكل مفتاح 120 في الدقيقة. |
أسئلة
هل يستطيع مفتاح رؤية طلبات مطعم آخر؟
فقدت مفتاحي. هل تعرضونه مرة أخرى؟
ذات صلة
لم تجد ما تبحث عنه؟ راسلنا على [email protected] أو تحدّث معنا من 9 صباحًا حتى 9 مساءً.مركز المساعدةالأسعارmenuthere.com