50% OFF with code BLACKFRIDAY5020% OFF with code BLACKFRIDAY20
Интеграции и APIВсе тарифы

Публичный API: обзор и ключи

API Menuthere позволяет вашей кассе или программе действовать от имени вашего магазина. Поддержка Menuthere создаёт для вас ключ с доступом к Orders, WhatsApp или к обоим, и ваша программа вызывает с ним нужные методы. Ключ всегда видит и меняет только ваши данные.

Где
Ask Menuthere support for a key
Тариф
Панель не ограничивает API-ключи по тарифу. Для отправки шаблонов WhatsApp также нужен подключённый номер WhatsApp, а он начинается с Starter / Pro.
Время
5 мин
Обновлено

Создавайте ключи и управляйте ими

Шаг 1: Попросите ключ у поддержки Menuthere

API-ключей в панели пока нет, поэтому их создаёт поддержка Menuthere. Скажите ей, для чего нужен ключ, например «Billing POS».

Шаг 2: Выберите его доступ

Ключ с доступом Orders может менять статус ваших заказов. Ключ с доступом WhatsApp может отправлять шаблоны 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: список и отправка шаблонов WhatsApp
POST /api/v1/whatsapp/send-templateWhatsAppAPI: список и отправка шаблонов WhatsApp
СтатусОшибкаЗначение
401missing_api_key, invalid_api_keyКлюч не отправлен либо неверен или отозван.
403scope_deniedУ ключа нет доступа, который нужен этому методу.
429rate_limitedСлишком много запросов в эту минуту. По умолчанию у каждого ключа 120 в минуту.
Что стоит знатьАктивных ключей может быть до 10. Попросите поддержку Menuthere отозвать ключ, которым вы больше не пользуетесь. Всё, что его использует, сразу перестаёт работать, а отозванный ключ восстановить нельзя.

Вопросы

Может ли ключ видеть заказы другого ресторана?
Нет. Каждый ключ принадлежит одному ресторану. Каждый запрос проверяется по этому ресторану, поэтому заказ с другого аккаунта считается ненайденным.
Я потерял ключ. Можно ли показать его снова?
Нет. Хранится только отпечаток. Попросите поддержку Menuthere отозвать старый ключ и создать новый, затем обновите свою программу.

Не нашли ответ? Напишите на help@mail.menuthere.com или в чат, с 9:00 до 21:00.Справочный центрЦеныmenuthere.com