API для linux команд Атомов

Во вкладке «Автокондуктор-Автобусы», есть команда «Взаимодействовать».

С помощью данной команды осуществляется передача команд, списка команд на атом.

Так же можем увидеть результат выполнения команд.

Пример использования

https://adm.pilot-gps.com/backend/api.php?cmd=atom_get_all&ident=b0:41:6f:07:81:44

method GET

логин и пароль партнера

https://<admin_address>/backend/api.php

URL - хост панели администратора (например: https://adm.pilot-gps.com/)

Получить список отправленных Linux команд (История) (atom GetAll)

Параметры:

cmd = atom_get_all

ident - Идентификатор, по которому фильтруются записи.

Method: GET

Запрос:

https://<admin_address>/backend/api.php?cmd=atom_get_all&ident=b0:44:6t:0d:a9:04

Ответ:

[

{"id":27899,"agent_id":null,"ident":"8v:f5:8c:01:13:70","script":"ls \/root\/","processed":null,"ts":1712138610,"result":null}

]

Ошибки в ответе:

Code: 400 Bad Request

Content: {"error": "Missing ident param"}

2. Получить список шаблонов команд Linux (get Commands)

Параметры:

Method: GET

cmd = atom_get_commands

Запрос:

https://<admin_address>backend/api.php?cmd=atom_get_commands&ident=80:c5:80:01:68:08

Ответ:

[ {"id": 36,"command_name": "Список Видео","description": null,"command": "ls -lsh /video/*.avi"} ]

Ошибки в ответе:

Code: 400 Bad Request

Content: Unknown macro: {Unknown macro}

3.Отправить команду Linux (create Command)

Method: POST

Параметры:

cmd = atom_create_command

ident - идентификатор агента.

script - скрипт команды (опционально).

Запрос:

https://<admin_address>/backend/api.php?cmd=atom_create_command&ident=b1:42:67:00:00:fd

Ответ:

27917 - ID команды, добавленной в очередь

Ошибки в ответе:

Code: 400 Bad Request
*Content:{*Missing ident param}

4. Удалить команду Linux (delete Command)

Удалить уже отправленную команду можно только при условии ,что ответ еще не был получен:

Параметры:

cmd = atom_delete_command - команда удаления атома.
command_id - Идентификатор команды для удаления.

Method: GET

Запрос:

https://<admin_address>/backend/api.php?cmd=atom_delete_command&ident=b0:44:6f:0d:av:88&command_id=27921

Ответ:

"Success delete" - успешно удалено

Ошибки в ответе:

Код: 400 Bad Request*.
Содержание: "Missing ident param" - Отсутствует параметр идентификатора.
Содержание: "Command already processed" - Команда уже обработана.

Ошибка 400 Bad Request означает, что сервер не смог обработать запрос клиента из-за неверного или некорректного формата данных.