метод REST scope: biconnector

biconnector.source.list

Получить список источников

Кто может выполнять: пользователь с доступом к разделу «Рабочее место аналитика»

Описание

Метод biconnector.source.list возвращает список источников по фильтру. Является реализацией списочного метода для источников.

Параметры

select string[] необязательный

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

filter object необязательный

Фильтр для выборки источников. Пример формата:

{
    "field_1": "value_1",
    "field_2": "value_2"
}

К ключам field_n можно добавить префикс, уточняющий работу фильтра.
Возможные значения префикса:
- >= — больше либо равно
- > — больше
- <= — меньше либо равно
- < — меньше
- @ — IN, в качестве значения передается массив
- !@ — NOT IN, в качестве значения передается массив
- % — LIKE, поиск по подстроке. Символ % в значении фильтра передавать не нужно. Поиск ищет подстроку в любой позиции строки
- =% — LIKE, поиск по подстроке. Символ % нужно передавать в значении. Примеры:
- "мол%" — ищет значения, начинающиеся с «мол»
- "%мол" — ищет значения, заканчивающиеся на «мол»
- "%мол%" — ищет значения, где «мол» может быть в любой позиции
- %= — LIKE (аналогично =%)
- = — равно, точное совпадение (используется по умолчанию)
- != — не равно
- ! — не равно

Список доступных полей для фильтрации можно узнать с помощью метода biconnector.source.fields.

Фильтр не поддерживает поле settings, оно будет проигнорировано

order object необязательный

Параметры сортировки. Пример формата:

{
    field_1: value_1,
    field_2: value_2,
    ...,
    field_n: value_n,
}
  • field_n — название поля, по которому будет произведена сортировка выборки источников
  • value_n — значение типа string, равное:
    - ASC — сортировка по возрастанию
    - DESC — сортировка по убыванию
page integer необязательный

Управление постраничной навигацией. Размер страницы результатов — 50 записей. Для перехода по результатам передавайте номер страницы

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"select":["id","title","active","dateCreate"],"filter":{"%=title":"Sql%","!description":"","@connectorId":[2,4]},"order":{"dateCreate":"DESC"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/biconnector.source.list

Ответ

HTTP-статус: 200

{
    "result": [
        {
            "id": "11",
            "title": "Sql_host",
            "active": true,
            "dateCreate": "2025-03-24 07:25:59"
        },
        {
            "id": "10",
            "title": "Sql_partner",
            "active": false,
            "dateCreate": "2025-03-21 12:22:32"
        }
    ],
    "time": {
        "start": 1742804947.923552,
        "finish": 1742804947.995446,
        "duration": 0.07189393043518066,
        "processing": 0.0017020702362060547,
        "date_start": "2025-03-24T08:29:07+00:00",
        "date_finish": "2025-03-24T08:29:07+00:00"
    }
}

Возвращаемые данные

result array

Корневой элемент ответа. Содержит массив объектов с информацией об источниках.

Стоит учитывать, что структура полей может быть изменена из-за параметра select

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 200

{
    "error": "VALIDATION_SELECT_TYPE",
    "error_description": "Parameter \"select\" must be array."
}
Код Описание Значение
VALIDATION_SELECT_TYPE Parameter "select" must be array. Параметр select должен быть массивом
VALIDATION_FILTER_TYPE Parameter "filter" must be array. Параметр filter должен быть массивом
VALIDATION_ORDER_TYPE Parameter "order" must be array. Параметр order должен быть массивом
VALIDATION_FIELD_NOT_ALLOWED_IN_SELECT Field "#TITLE#" is not allowed in the "select". Данные поля недопустимы в выборке
VALIDATION_FIELD_NOT_ALLOWED_IN_FILTER Field "#TITLE#" is not allowed in the "filter". Данные поля недопустимы в фильтре
VALIDATION_FIELD_NOT_ALLOWED_IN_ORDER Field "#TITLE#" is not allowed in the "order". Данные поля недопустимы для сортировки

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.