Работа с REST API
02 мая 2024
ID 204471
Работа с MDR с помощью REST API включает получение, создание и обновление активов, инцидентов, действий по реагированию и пользователей.
Для методов REST API требуется значение client_id
. Вы можете получить значение client_id
в разделе Информации о токене любого токена обновления в Консоли MDR.
Ниже приведены примеры скриптов для Python и Shell, демонстрирующие основные возможности REST API:
- Определение пути к сертификату, веб-адреса REST API, идентификатора клиента и токенов.
- Получение токена доступа и токена обновления для следующего обновления токена доступа.
- Получение номера актива.
- Получение списка активов или подробной информации об активах.
- Получение количества инцидентов, списка инцидентов или деталей инцидента.
- Получение списка действий по реагированию на инцидент.
- Подтверждение и отклонение действий по реагированию или обновление списка действий по реагированию.
- Получение списка комментариев для указанного инцидента или создание комментария для указанного инцидента.
Пример (Python):
|
Пример (Shell):
|
Пример ответа REST API с токеном доступа и новым токеном обновления:
{
"access_token": "SamPLET346yoKEnSamPLEToK25EnSamPLEToK35EnS",
"refresh_token": "tOKenSaMPlet259OKenS123aMPle926tOKenSaMPle"
}
Пример ответа REST API со структурой и значениями комментариев:
[{
"comment_id": "bfu6TiNghqp",
"author_name": "Иван Иванов",
"text": "<p>
Первый комментарий.
</p>",
"creation_time": 1601295428640
}, {
"comment_id": "bfu6TiNghqt",
"author_name": "Мария Ивановна",
"text": "<p>
Второй комментарий.
</p>",
"creation_time": 1601295433441
}]
Пример ответа REST API, если REST API создает комментарий и отправляет действие по реагированию с деталями комментария:
{
"comment_id": "AXTej0Qi4bfu6TiNgmvT",
"author_name": "Название токена",
"text": "
Это новый комментарий, созданный с помощью REST API.
",
"creation_time": 1601461748122
}