API
Application Programming Interface — tizimlar o'rtasidagi aloqa uchun protokollar to'plami. API POS, CRM, kuryer xizmatlari va to'lov tizimlarini yetkazib berish platformasiga ulash imkonini beradi. Ochiq API — yetuk platformaning belgisi.
Зачем ресторану знать про API
API — это способ одной программы разговаривать с другой без человека посередине. Для заведения это звучит абстрактно, пока не возникает вопрос «почему заказы из приложения не попадают в кассу сами». Ответ почти всегда в API: либо у кассы его нет, либо он умеет меньше, чем нужно, либо доступ к нему не выдан. Поэтому при выборе любой системы практический вопрос один — есть ли открытый API и что именно через него можно сделать.
Что спрашивать у поставщика
Четыре вопроса закрывают девяносто процентов проблем. Есть ли документация в открытом доступе. Можно ли через API и читать, и записывать — или только читать. Какие есть ограничения по частоте запросов. Что происходит при сбое: теряется запрос или повторяется. Если на первый вопрос ответ «документацию дадим после подписания», это само по себе информация: интеграция будет небыстрой.
Как это устроено в Delever
Delever подключается к внешним системам через их API и отдаёт свой. Сейчас на платформе более пятидесяти интеграций: шестнадцать кассовых систем, тринадцать платёжных, одиннадцать агрегаторов, пять служб доставки, четыре SMS-шлюза, плюс аналитика, фискализация и телефония. Если у вашего поставщика есть API, подключение решается проектно — именно так в список попадают локальные системы, которых не было изначально.
Частые ошибки
Первая — считать интеграцию разовой работой: API меняются, и обмен нужно сопровождать. Вторая — выдавать интеграции права на всё: токен с полным доступом к кассе — это риск, который не нужен для приёма заказов. Третья — не проверять обмен на реальном объёме: интеграция, которая работает на пяти тестовых заказах, может не выдержать двухсот в час пик.
FAQ
Нужен ли программист, чтобы подключить интеграцию?
Для готовых интеграций из списка — нет, подключение делается настройкой. Программист нужен, когда интеграции с вашей системой ещё не существует и её надо написать.
Чем API отличается от выгрузки файлов?
Выгрузка — это снимок на момент времени, его кто-то должен запустить. API отдаёт данные по запросу в момент, когда они нужны. Для стоп-листов разница критична: файловая выгрузка раз в час означает час продажи того, чего нет.
Безопасно ли открывать доступ к кассе через API?
При соблюдении двух условий — отдельный токен с минимально нужными правами и возможность его отозвать. Общий админский доступ для интеграции выдавать не нужно.