Публичный API: обзор и ключи
API Menuthere позволяет вашей кассе или программе действовать от имени вашего магазина. Поддержка Menuthere создаёт для вас ключ с доступом к Orders, WhatsApp или к обоим, и ваша программа вызывает с ним нужные методы. Ключ всегда видит и меняет только ваши данные.
- Где
- Ask Menuthere support for a key
- Тариф
- Панель не ограничивает API-ключи по тарифу. Для отправки шаблонов WhatsApp также нужен подключённый номер WhatsApp, а он начинается с 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}/status | Orders | API: изменение статуса заказа |
| GET /api/v1/whatsapp/templates | API: список и отправка шаблонов WhatsApp | |
| POST /api/v1/whatsapp/send-template | API: список и отправка шаблонов WhatsApp |
| Статус | Ошибка | Значение |
|---|---|---|
| 401 | missing_api_key, invalid_api_key | Ключ не отправлен либо неверен или отозван. |
| 403 | scope_denied | У ключа нет доступа, который нужен этому методу. |
| 429 | rate_limited | Слишком много запросов в эту минуту. По умолчанию у каждого ключа 120 в минуту. |
Вопросы
Может ли ключ видеть заказы другого ресторана?
Я потерял ключ. Можно ли показать его снова?
См. также
Не нашли ответ? Напишите на [email protected] или в чат, с 9:00 до 21:00.Справочный центрЦеныmenuthere.com