Gradients.app
4 поста
Как я устал от Postman и сделал инструмент для рестораторов на iiko API
Привет! Я делаю сервис, который упрощает работу с iiko API для ресторанов и их подрядчиков. Если коротко — это «человеческий интерфейс» для API iiko: можно посмотреть актуальное меню и стопы, сделать демо-заказ, проверить типы скидок/доставок/оплат и не ковыряться каждый раз в ручных запросах.
Сам сайт — https://apimenu.ru/
Главная страница сервиса на которой нужно ввести только АПИ ключ
Зачем вообще это нужно?
Если вы когда-нибудь настраивали интеграцию с iiko или просто с ней работали, вы знаете боль:
искать нужные запросы в документации,
искать модификаторы по ID,
постоянно авторизироваться,
все запросы дёргать через Postman,
а потом объяснять менеджеру, почему «товар не в стопе» (сделав 10 запросов до этого).
Мне надоело постоянно делать запросы для разных ключей и организация и решил как-то это упростить. Сделал одну панель, куда добавляешь ключ и авторизируешься, и сразу видишь ответ iiko: организаци и терминалы, меню, стоп-листы, скидки, способы оплаты, статусы и т.п. в одном месте без кучи запросов.
После ввода и авторизации получаем все основные данные по организациям привязанным к ключу
Что уже работает
Просмотр меню и цен. Подтягивает меню и прайсы, показывает дерево категорий и блюда. Делится на 2 типа — номенклатура и внешнее меню.
Корзина и модификаторы. Можно «собрать» тестовый заказ как обычный пользователь: выбираете блюдо → модалки для модификаторов → корзина (но только для внешнего меню)
Демо-заказ в iiko. Выбираете организацию и терминал, подгружаются доставки и оплаты, добавляете тестовые позиции и отправляете заказ — показывает JSON-запрос и JSON-ответ от iiko, после теста сразу можно проверить статус заказа.
Стоп-листы. Подсветка недоступных позиций.
iiko Biz. Страница, где собираю ошибки с которыми встречаюсь при интеграции.
Логи запросов. Сохраняю JSON по ключевым операциям (getOrganizations, getMenus и т.д.) и можно всё посмотреть в модальном окне и скачать. (удобно для обращение в ТП)
Справочник ошибок iiko. Страница, где собираю ошибки с которыми встречаюсь при интеграции.
Хранилище ключей для пользователя. Переключение в один клик между ключами.
И ещё много всякого разного, веду историю изменений, можете почитать — https://apimenu.ru/changelog
Внешнее меню ресторана. Видно основные даныне блюд, можно посмотреть модификаторы и узнать в топе или отключено блюдо.
Для кого это полезно
Директорам/менеджерам. Видно «что реально в продаже» и как срабатывают стопы— без звонка интегратору.
Техспециалистам и подрядчикам. Экономит время: не открывать Postman, меньше человеческих ошибок в параметрах, быстрый отладочный цикл.
Небольшим сетям. Когда «своего айтишника» нет, но проверять меню и тестировать правила нужно регулярно.
Примеры сценариев, которые занимают минуты и можно проверить даже с телефона
«Меню обновили, а на сайте не поменялось» — открываю нужную точку, нужное меню и орнанизация, ищем товар — смотрим, есть он или нет, а может у него нулевая цена или он в стопе.
«Модификатор убрали в стоп, а на сайте он есть» — смотрим меню, ищем товар и смотрим, что у клиента 2 одинаковых наименование, один товар, а другой модификатор и в стоп они убрали товара, а модификатор отображается как и должен.
«Скидка 10% не применялась, хотя вроде скиду добавили» — выбираю организацию и проверяю наличие скидки по id или названию.
Пример логов при загрузки меню. Можно посмотреть каждый запрос отдельно или скачать общий файл лога
Итог
Я просто устал объяснять людям «почему не поменялись стопы» и каждый раз собирать запросы в Postman. Сделал сайт, где всё разложил по полочкам — от меню и модификаторов до тестового заказа и логов. Мне очень сильно экономит время на внедрениях и проверках.
Буду рад какому-то фидбеку от рестораторов и работников хорики.
P.S. ключи не сохраняем, если только сами не сохраните в своем ЛК
Показать полностью
4
