Обновление дополнительных полей транспорта
Этот API изменяет значения дополнительных полей транспорта одним запросом по agent_id или imei. Можно менять сразу все поля или их часть, количество полей не ограничено.
Метод
POST
Адрес запроса
Для получения данных используйте адрес: https://<server_address>/api/api.php
Заголовки
Content-Type: application/json
Authorization: Basic <ваши_учётные_данные>
Параметры запроса
-
cmd=agent_update_custom_fields — команда для API
-
agent_id — идентификатор транспортного средства (если не используете imei).
-
imei — IMEI устройства ТС (если не используете agent_id).
-
custom_fields — объект с парами ключ-значение для обновления дополнительных полей
В custom_fields можно указывать любое количество полей, например extra_field1, extra_field2, … extra_fieldN (при условии, что эти поля созданы в аккаунте). Значения полей могут быть числами, строками или булевыми значениями
Пример запроса
Обновление нескольких полей по agent_id:
curl --location 'https://<server_address>/api/api.php'
--header 'Content-Type: application/json'
--header 'Authorization: Basic dGVzdDExMUB0ZXN0LnJ1OkRlbW9fMjAyMg==' \
--data '{
"cmd": "agent_update_custom_fields",
"agent_id": 30547,
"custom_fields": {
"extra_field1": "Путевой лист №123",
"extra_field2": "2025-11-01",
"extra_field7": "+79000000000"
}
}'
|
Обновление по imei:
curl --location 'https://<server_address>/api/api.php'
--header 'Content-Type: application/json'
--header 'Authorization: Basic dGVzdDExMUB0ZXN0LnJ1OkRlbW9fMjAyMg==' \'
--data '{
"cmd": "agent_update_custom_fields",
"imei": "359339099999999",
"custom_fields": {
"extra_field3": "Пропуск №A12345",
"extra_field4": "2025-12-31"
}
}'
|
Пример ответа
{
"code": 1,
"msg": "OK"
}
|
В ответ на API-запрос возвращается:
-
code — код выполнения: 1 — успешно, 0 — ошибка
-
msg — текстовое описание результата (например, "OK" или сообщение об ошибке)