Руководство пользователя
Версия 7.5
×

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

 
Во вкладке «Автокондуктор-Автобусы», есть команда «Взаимодействовать». С помощью данной команды осуществляется передача команд, списка команд на атом. Так же можем увидеть результат выполнения команд.
 
 
 
Пример   использования
method GET
логин и пароль партнера
https://<admin_address>/backend/api.php
URL - хост панели администратора (например: https://adm.pilot-gps.com/)
 
 
1.Получить список отправленных 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 proccessed" - Команда уже обработана.