#Список привязок

GET /v1/timeline-logs/:id/bindings

Возвращает все CRM-сущности, к которым привязана лог-запись. Удобно проверить, в каких таймлайнах сейчас отображается событие.

#Параметры

Параметр Тип Обяз. Описание
id (path) number да ID лог-записи

#Примеры

#curl — личный ключ

Terminal 
curl https://vibecode.bitrix24.tech/v1/timeline-logs/5012/bindings \
  -H "X-Api-Key: YOUR_API_KEY"

#curl — OAuth-приложение

Terminal 
curl https://vibecode.bitrix24.tech/v1/timeline-logs/5012/bindings \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

#JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/timeline-logs/5012/bindings', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})

const { data, total } = await res.json()
data.forEach(b => console.log(`${b.entityType} #${b.entityId}`))

#JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/timeline-logs/5012/bindings', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { data, total } = await res.json()

#Поля ответа

Поле Тип Описание
success boolean Всегда true при успехе
data array Массив привязок
data[].ownerId number ID самой лог-записи (равен :id из пути, продублирован для удобства)
data[].entityId number ID привязанной CRM-сущности
data[].entityType string Строковый тип: "deal", "contact", "dynamic_174" и т. п.
data[].entityTypeId number Числовой тип. Присутствует, если строка маппится в таблицу типов; для произвольных смарт-процессов извлекается из dynamic_<id>
total number Количество привязок

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

JSON 
{
  "success": true,
  "data": [
    { "ownerId": 5012, "entityId": 100, "entityType": "deal", "entityTypeId": 2 },
    { "ownerId": 5012, "entityId": 50, "entityType": "contact", "entityTypeId": 3 },
    { "ownerId": 5012, "entityId": 10, "entityType": "company", "entityTypeId": 4 },
    { "ownerId": 5012, "entityId": 1, "entityType": "dynamic_174", "entityTypeId": 174 }
  ],
  "total": 4
}

#Пример ответа при ошибке

400 — id некорректен:

JSON 
{
  "success": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Path parameter :id must be a positive integer"
  }
}

#Ошибки

HTTP Код Описание
400 INVALID_PARAMS id не положительное целое
422 BITRIX_ERROR Битрикс24 отклонил запрос
403 SCOPE_DENIED API-ключ не имеет скоупа crm
401 TOKEN_MISSING API-ключ не имеет настроенных токенов

Полный список общих ошибок API — Ошибки.

#Известные особенности

Родительская сущность входит в список. При создании записи через `POST /v1/timeline-logs` пара entityTypeId+entityId автоматически добавляется в bindings. Поэтому даже без явных bind-вызовов total ≥ 1.

Оба формата типа в одном объекте. Вайбкод возвращает и entityType (строка из B24), и entityTypeId (число) — для удобства клиента. Если значение строки не маппится (нестандартный смарт-процесс с entityTypeId < 128 без ясного названия), entityTypeId может отсутствовать в объекте.

Несуществующий id — пустой массив, не 404. Если запросить bindings для несуществующей лог-записи, B24 отдаст total: 0, data: [] без ошибки. Чтобы проверить существование записи — используйте `GET /v1/timeline-logs/:id`.

Сортировка не задаётся параметром. Список приходит обычно по entityId возрастанию, но порядок не гарантирован. Если нужен предсказуемый порядок — сортируйте на клиенте.

#Смотрите также