Получение списка заданий типа интеграции

Запрос

Тип	Метод
POST	/integration_jobs/search

Описание: При выполнении запроса будет возвращен список заданий для типа интеграции.

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

POST

Development server
https://development.gigantic-server.com/v1/integration_jobs/search

Staging server
https://staging.gigantic-server.com/v1/integration_jobs/search

Тело запроса:

Параметр	Тип данных	Обязательность	Описание
include_fields	Array<string>	Required	Список полей для выборки. Если модель содержит поля, не указанные в запросе, они будут отсутствовать в ответе
exclude_fields	Array<string>	Required	Список полей для удаления из выборки. Если модель содержит поля, указанные в запросе, они будут отсутствовать в ответе
filters	Array<filters>	Required	Список фильтров по полям модели
ordering	Array<ordering>	Required	Настройки сортировки
virtual_search	object<virtual_search>	Required	Поле для поиска по подстроке по всем строковым полям модели и настройка строгого поиска
relations	Array<string>	Required	Список связей для выборки. Список доступных связей отображается в ответе запроса на получение метаданных - “/_meta”
limit	integer	Required	Лимит выдачи найденных объектов
offset	integer	Required	Отступ от начала результата поиска в базе
_relations	Array<string>	Optional	Перечисление связанных сущностей идентификаторы которых нужно вернуть в ответе в поле _relations

Array of filters

Параметр	Тип данных	Обязательность	Описание
field	string	Required	Название поля модели
value	object	Required	Значение для фильтрации
filter_type	string	Required	В зависимости от этого значения определяется допустимые значения в поле value. Допустимые значения: - equal -> строка|число, проверяет равенство значений - substr -> строка, проверяет вхождение подстроки - intersection -> массив (тип элемента зависит от типа поля), проверяет вхождение значения поля в переданный массив - range -> массив (тип элемента зависит от типа поля), проверяет вхождение значения поля в переданный диапазон - related -> строка или массив строк (uuid), проверят связанность с моделью по идентификатору если value: [], проверяет наличие или отсутствие связанных сущностей - exists -> значение отсутствует, проверяется равенство колонки с null
negation	boolean	Optional	Флаг использования отрицания при проверке фильтра

Array of ordering

Параметр	Тип	Обязательность	Описание / Допустимые значения
field	string	Required	Поле модели выбранное для сортировки
direction	string	Required	Направление сортировки. Допустимые значения: - asc - desc

Object VirtualSearch

Параметр	Тип	Обязательность	Описание / Допустимые значения
value	string	Required	Значение выбранное для поиска
strict	boolean	Required	Опция, включающая строгий поиск. Возможные значения: - true - строгий поиск включена; - false - строгий поиск выключен.

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

{
  "include_fields": [
    "string"
  ],
  "exclude_fields": [
    "string"
  ],
  "filters": [
    {
      "field": "string",
      "value": [
        "name",
        [
          "value1",
          "value2"
        ]
      ],
      "filter_type": "equal",
      "negation": false
    }
  ],
  "ordering": [
    {
      "field": "string",
      "direction": "asc"
    }
  ],
  "virtual_search": {
    "value": "string",
    "strict": false
  },
  "relations": [
    "service_asset_findings",
    "logmule_go_rules",
    "user"
  ],
  "limit": 20,
  "offset": 0,
  "_relations": [
    "string"
  ]
}

Успешный ответ

Статус код: 200 – успешный ответ.

Формат: JSON.

Параметры ответа:

Параметр	Тип данных	Описание
items	Array <IntegrationJobsMeta>	Список найденных заданий для типа интеграции
total	integer	Количество найденных журналов

Пример ответа

{
  "items": [
    {
      "id": "77900337-8623-436c-a807-3965f6fa26ab",
      "integration_id": "ce09662b-c945-49df-8fa7-10cda414af14",
      "integration_action_id": "80b95c78-e16c-43a3-b167-53fdef99ad89",
      "integration_script_id": "2cb79064-cda1-4b55-a5c5-6476f50e6871",
      "incident_id": "2f811c5b-b888-4fb3-aac5-3c6a4b05df32",
      "service_asset_id": "d087b2ff-c34c-4322-bde8-4ad774fec175",
      "rule_id": "728c1541-d6d1-4290-9a53-cdf01dd32d60",
      "executed_at": "2025-03-19T09:34:13.676838Z",
      "result_at": "2025-03-19T09:34:21.788282Z",
      "executed_by": "93adf94b-0f93-45d1-8b3c-a15a38399d49",
      "params": {},
      "result": "ERROR: The process \"432\" not found.",
      "return_code": 1,
      "integration": null,
      "integration_action": "null,",
      "integration_script": null,
      "service_asset": null,
      "logmule_go_rule": null,
      "_relations": {}
    }
  ],
  "total": 1
}

Другие возможные ответы

Код	Ответ	Описание
400	Bad Request	Неверный тип параметра запроса, либо отсутствует обязательный параметр
500	Internal Server Error	Другие ошибки при удалении объектов

Примечание: Текст ошибки не фиксированный, может изменяться в зависимости от фактического ответа получателя запроса.

Пример ответа

   
Код 400
   

{
  "error": "Bad Request",
  "error_code": 400
}



   
Код 500
   

{
  "error": "Internal Server Error",
  "error_code": 500
}