Skip to main content

GET - Список действий

Описание

Эндпоинт GET /check-lists/actions позволяет получить список действий, связанных с чек-листами. Поддерживается фильтрация, сортировка и постраничный вывод результатов.


Авторизация

Для доступа к этому эндпоинту необходимо предоставить действительный токен доступа в заголовке Authorization.

Пример использования токена в заголовке:

Authorization: Bearer YOUR_API_TOKEN

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

ПараметрОписаниеПример значенияЗначение по умолчанию
limitОграничивает количество возвращаемых элементов.202147483647
offsetПропускает указанное количество элементов в начале коллекции.00
sortПараметры сортировки (поле и направление).id,ascid,asc
nameФильтрация по названию действия.Check panel
checkListIdФильтрация по ID чек-листа.in:99b267f4-9cf1-45cd-a9cb-4ef2b64e3a61

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

URL:

https://api.targpatrol.com/v1/check-lists/actions?name=Check%20panel&limit=20

Заголовки:

Authorization: Bearer YOUR_API_TOKEN

Пример успешного ответа

Код состояния:

200 OK

Тело ответа:

{
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "Device sounds loudly",
"type": "BOOLEAN"
}
],
"meta": {
"offset": 0,
"limit": 20,
"count": 1000,
"sort": [
{
"property": "id",
"direction": "asc"
}
]
}
}

Пример ошибки

Код состояния:

500 Internal Server Error

Тело ответа:

{
"message": "internal server error",
"code": "internal.server.error",
"timestamp": "2023-03-07T05:57:59.315Z"
}

Заключение

Этот эндпоинт полезен для получения списка действий в рамках конкретных чек-листов, а также для фильтрации результатов по названию или ID чек-листа. Убедитесь, что в заголовке запроса указан действующий токен авторизации.