...
Также будет предоставлен секретный ключ (тестового и боевого окружения) для идентификации системы внешних наливов в Топаз "Web Офис". Данный ключ необходимо будет передавать во всех запросах от внешней системы в Топаз "Web Офис" в заголовке externalSystemApikey
Базовый URL для запросов:
https://topazoffice.ru/ms/external-fueling/integration
Получение списка АЗС и их конфигураций
Внешняя система опрашивает Топаз "Web Офис" для получения списка АЗС и их конфигураций через HTTP запрос на url с префиксом /integration/station?apikey={apikey }, запрос типа GET , timeout 10 секунд.
В ответ Топаз "Web Офис" дает ответ в формате JSON
Блок кода | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||
{ // идентификатор станции АЗС string Id // статусполе станции:Id trueдля -заказа доступна,должно false - выключена bool Enable, // наименование станции string Name, // адрес станции string Address, // гео точка на карте location Location { double Lat, double Lon }, // словарь доступных ТРК Dictionary Columns { // номер колонки (int32) Key: { // список доступных типов топлива "Fuels": [ "a92", "a95", "diesel_premium", ... N ] } } ... N } |
...
быть уникальным, не содержать пробелы и иметь максимальную длину - 60 символов string Id // статус станции: true |
...
- доступна, false |
...
- выключена bool Enable, // наименование станции string Name, // адрес станции string Address, // гео точка на карте location Location { double Lat, double Lon }, // словарь доступных ТРК Dictionary Columns { // номер колонки (int32) Key: { // список доступных типов топлива "Fuels": [ "a92", "a95", "diesel_premium", ... N ] } } ... N } |
...
Возможные идентификаторы топлива
ID | Марка |
diesel | дизель |
diesel_premium | брендированный дизель |
a80 | бензин марки А80 |
a92 | бензин марки А92 |
a92_premium | брендированный бензин марки А92 |
a95 | бензин марки А95 |
a95_premium | брендированный бензин марки А95 |
a98 | бензин марки А98 |
a98_premium | брендированный бензин марки А98 |
a100 | бензин марки А100 |
a100_premium | брендированный бензин марки А100 |
propane | газ пропан |
metan | метан |
Получение прайс-листа
Внешняя система опрашивает Топаз "Web Офис" для получения прайс-листа HTTP запросом на url с префиксом /integration/price?apikey={apikey} , запрос типа GET , timeout 10секунд.
...
Информирование Топаз "Web Офис" о заказе и их статусах осуществляется HTTP запросом на url с префиксом /integration/order , запрос типа POST , timeout 10 секунд.
...
Перед формирование заказ внешняя система делает запрос на станцию для определения доступности и готовности станции принять заказ url с префиксом
/integration/ping?apikey={apikey}&stationId={stationId}&columnId={columnId}, stationId – идентификатор станции
...