×

Добавление заправки по карте

Этот API добавляет запись о расходе топлива по карте, включая информацию о количестве топлива, стоимости, месте и водителе.

Как получить данные

Метод

POST

Адрес запроса

Для выполнения запроса используйте адрес: https://<server_address>/api/api.php?

Параметры запроса

Обязательные:
  • cmd=add_fuel_transaction — команда для добавления транзакции
  • card_num — номер топливной карты
  • operation — тип операции (например, refill)
  • unixtimestamp — время транзакции в формате Unix timestamp
  • place — место проведения операции
  • azs — название АЗС
  • liters — количество литров топлива
  • fuel — тип топлива
  • price — цена без скидки
  • sum — сумма без скидки
  • node — номер узла, на котором нужно выполнить команду
Необязательные:
  • priceg — цена со скидкой
  • sumg — сумма со скидкой
  • driver — ФИО водителя
  • lat — широта места транзакции
  • lon — долгота места транзакции
  • info — дополнительная информация
  • internal_id — внутренний идентификатор транзакции
 

Пример запроса

https://<server_address>/api/api.php?cmd=add_fuel_transaction&node=1
Пример тела запроса (JSON):
{
  "card_num": "1234567890123456",
  "operation": "refill",
  "unixtimestamp": 1695000000,
  "place": "Main street 12",
  "azs": "WOG",
  "liters": 50,
  "fuel": "Diesel",
  "price": 55.0,
  "sum": 2750.0,
  "driver": "Ivan Ivanov"
}
Ответ
{
  "code": 0,
  "msg": "OK"
}
В ответ на API-запрос возвращается:
  • code — код результата (0 — успешная операция)
  • msg — сообщение сервера о результате действия