Выберите сценарий
Для серверного доступа к каталогу и создания предзаказов выберите партнёрские предзаказы. Для передачи заказов из другой системы используйте внешний приём заказов. Гостевые интерфейсы используют персональные токены и проверку контакта вместо общего ключа ресторана.
Подготовьте доступ
Администратор ресторана выбирает организацию и заведение в Hallify, включает нужный канал или подключение провайдера и выдаёт необходимые права. Ключи создаются в существующих настройках. Просмотр документации не создаёт ключ доступа.
Подготовьте первый запрос
Базовый адрес публичного серверного API — https://api.hallify.co. Прокси /api на сайте — инфраструктура приложения, а не отдельный интеграционный API. Первые запросы выполняйте только в тестовом заведении, явно согласованном с владельцем; документация не создаёт sandbox.
Откройте первый метод руководства, изучите условия, скопируйте cURL или TypeScript и замените вымышленные идентификаторы значениями из Hallify. Проверьте HTTP-статус и тело ответа перед следующим шагом. Идентификаторы, токены, даты и ответы в примерах не относятся к реальным ресурсам.
Обрабатывайте рабочие ситуации
Храните ключи на сервере. Сохраняйте возвращённые ссылки, ревизии и сроки действия. Повторно используйте ключ идемпотентности только для повтора той же команды. Обрабатывайте истечение срока, конфликты и повторы webhooks по контракту выбранного метода.