...
Также будет предоставлен секретный ключ (тестового и боевого окружения) для идентификации системы внешних наливов в Топаз "Web Офис". Данный ключ необходимо будет передавать во всех запросах от внешней системы в Топаз "Web Офис" в заголовке externalSystemApikey
Базовый URL для запросов:
https://topazoffice.ru/ms/external-fueling/integration
Получение списка АЗС и их конфигураций
Внешняя система опрашивает Топаз "Web Офис" для получения списка АЗС и их конфигураций через HTTP запрос на url с префиксом /integration/station?apikey={apikey }, запрос типа GET , timeout 10 секунд.
В ответ Топаз "Web Офис" дает ответ в формате JSON
Блок кода | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
// идентификатор станции АЗС
// поле Id для заказа должно быть уникальным, не содержать пробелы и иметь максимальную длину - 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 – идентификатор станции
...