Общий принцип обмена данными БИТ Аппетита с сервисом WEB доставки
В данной схеме интеграции БИТ Аппетит выступает в качестве клиента, который инициирует обмен данными по средствам HTTP запросов к серверу сервиса доставки. Таким образом на стороне сервера должна быть реализована обработка запросов, которые БИТ Аппетит периодически отправляет к нему. Этот подход к построению обмена позволяет на одном сервере интернет доставки обслуживать работу нескольких ресторанов с автономной установкой БИТ Аппетита.
Обмен данными условно можно разделить на 2 типа запросов:
- Отправка справочных данных.
- Передача заявки на доставку в БИТ Аппетит.
Формат HTTP запросов
Запросы, которые осуществляет БИТ Аппетит, представляют собой GET/POST запросы следующего вида:
http(s)://{host}:{port}/{page_prefix}{page}{page_suffix}?{parameter1}={value1}&{parameter2}={value2} ... {parameterN}={valueN}
Статус HTTP ответа в случае ошибки должен быть 200.
Где параметры имеют следующие значения
- host - сетевой адрес
- port - порт tcp/ip порт соединения (80 по умолчанию)
- page_prefix - путь к странице
- page - наименование страницы (метод API)
- page_suffix - суффикс страницы (например расширение .php или .html)
- parameterN - имя параметра
- valueN - значение параметра.
Для передачи параметров содержащих XML структуру предварительно используется кодирование строки в BASE64.