# Изменения API: 29 октября 2026

[← Журнал изменений](/docs/changelog) · [Октябрь 2026](/docs/changelog/2026-10)

### NEW-1029-1: Источники и каналы сквозной аналитики

Через API Вайбкод можно читать [источники](/docs/entities/crm-tracking/sources-list) и [каналы](/docs/entities/crm-tracking/channels-list), создавать и изменять свои источники, отправлять их в архив и возвращать из архива. Встроенный источник доступен по коду, даже если ещё не настроен.

Методы в процессе раскатки с обновлением `crm 26.2100.0`. Маршруты работают под флагом `crm-tracking-v3` и включатся вместе с возможностью Битрикс24. Пока метод недоступен, ответ — `422 METHOD_NOT_YET_AVAILABLE`.

### FIX-1029-2: список рабочих групп доступен без изображения группы

**Было**

Запрос [GET /v1/me/workgroups](/docs/me/workgroups) завершался HTTP 502 `BITRIX_UNAVAILABLE`, если Битрикс24 возвращал `null` вместо ссылки на изображение хотя бы одной группы.

**Стало**

Группа без изображения остаётся в полном списке. Отсутствующая или пустая ссылка, включая `null`, возвращается как `groupImage: ""`; пустой идентификатор изображения — как `groupImageId: 0`, а пустой признак экстранета — как `isExtranet: false`. Непустой идентификатор изображения сохраняется даже без ссылки.

**Влияние на интегратора**

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

### FIX-1029-3: Схема воронок описывает isSystem и отсутствие createdDate

**Было**

Поле `isSystem` воронок контактов и компаний приходило в ответах, но не было описано в [схеме воронки](/docs/entities/categories/fields), и `select=isSystem` давал предупреждение `UNKNOWN_SELECT_FIELD`. Поле `createdDate` было описано в схеме как обычное, хотя Битрикс24 его не возвращает.

**Стало**

`isSystem` описан в схеме и в OpenAPI строкой `Y` или `N`, как его отдаёт Битрикс24, и выбирается в `select` без предупреждения. Значение в ответе не изменилось. Запись `isSystem`, как и раньше, уходит в Битрикс24 без изменений: создать воронку с `isSystem: "Y"` Битрикс24 не даёт, а при обновлении поле не применяет. Схема и документация теперь говорят об этом прямо. `createdDate` помечен `notReturned: true`, в OpenAPI — `x-notReturned: true`. Запрос с `select=createdDate` по-прежнему отвечает HTTP 200, а в `meta.warnings` приходит `UNKNOWN_SELECT_FIELD`.

**Влияние на интеграторов**

Менять ничего не нужно. Не стройте сортировку и отображение на `createdDate`: значения у этого поля нет.

### FIX-1029-4: регистрация бота не обещает повтор, если ожидание ничего не изменит

**Было**

Когда регистрация бота останавливалась на состоянии, которое не исправится само, `POST /v1/bots` отвечал `409 BOT_EFFECT_IN_PROGRESS` с заголовком `Retry-After`. Повтор через указанное время получал тот же ответ, и так без предела. Такие состояния — например, код, занятый ботом с другим идентификатором, или отозванные права ключа на запись.

**Стало**

Такой отказ приходит как `409 BOT_UNAVAILABLE` без заголовка `Retry-After`. Отказы, которые снимаются собственной работой платформы, по-прежнему приходят как `409 BOT_EFFECT_IN_PROGRESS` с `Retry-After`: эта ветка не изменилась.

**Влияние на интеграторов**

Обрабатывайте `BOT_UNAVAILABLE` как требующий вмешательства: не повторяйте запрос по таймеру, а проверьте, не занят ли код другим ботом, и права ключа на запись. Ответ с `BOT_EFFECT_IN_PROGRESS` и заголовком `Retry-After` обрабатывается как прежде.

### NEW-1029-5: Свой домен сервера через API

Собственный домен приложения теперь подключается по API-ключу, без кабинета. `POST /v1/infra/servers/:id/domain` привязывает домен и возвращает DNS-записи, которые нужно создать у DNS-провайдера: тип, имя относительно зоны и значение. `GET /v1/infra/servers/:id/domain` отдаёт состояние домена и те же записи. `POST /v1/infra/servers/:id/domain/verify` проверяет записи и включает домен, в ответе статус по каждой записи. `DELETE /v1/infra/servers/:id/domain` отвязывает домен.

Вызывать операции может только ключ, который управляет сервером, остальным ключам они отвечают `404 SERVER_NOT_FOUND`. Привязка, проверка и отвязка требуют скоупа `vibe:infra`. Пока функция не включена для владельца сервера, привязка и проверка отвечают `403 CUSTOM_DOMAINS_DISABLED`, для региона аккаунта Битрикс24 без поддержки своих доменов — `403 CUSTOM_DOMAINS_ZONE_UNSUPPORTED`, без коммерческого тарифа — `403 CUSTOM_DOMAINS_REQUIRE_COMMERCIAL`.

Проверка ограничена пятью вызовами в минуту. Если записи не сошлись, она отвечает `422 DOMAIN_VERIFICATION_FAILED`, а поле `error.details.hint` объясняет, когда её повторять: изменение DNS публикуется не сразу, и повтор без паузы вернёт тот же результат.

### BC-1029-6: Подписанные ссылки на ресурсы и блокировка обновления токенов

> Поддержка старого формата до: не предусмотрена

**Было**

[POST /v1/infra/servers/:id/access-tokens/:tokenId/refresh](/docs/infra/access-tokens/refresh) мог отвечать `200`, если текущий или записанный прежний издатель `api-bearer` заблокирован, но сам токен ещё не отозван.

**Стало**

В этом случае обновление токена отвечает `403 KEY_BLOCKED`. Прежний успешный ответ не поддерживается. Штатная ротация ключа без блокировки издателя сохраняет возможность обновления действующего токена.

**Добавлено**

[POST /v1/infra/servers/:id/access-tokens/:tokenId/resource-url](/docs/infra/access-tokens/resource-url) выдаёт ссылку для GET/HEAD одного CSS, изображения или шрифта на основе существующего токена `api-bearer`. Ссылка привязана к пути и приложению, действует до 30 дней, но не дольше родителя, и закрывается при его отзыве. Для виджета Главной с доступом PORTAL используйте подписанный URL стиля и отдельные подписанные URL его изображений; обновляйте регистрацию до истечения срока. Пользовательская сессия для загрузки этих ресурсов не требуется.

Если текущий или записанный прежний издатель заблокирован, выдача ссылки отклоняется с `403 KEY_BLOCKED`.

Временно недоступный ресурс возвращает `503 BH_RESOURCE_UNAVAILABLE`. Отозванная или недействительная ссылка возвращает `401 BH_RESOURCE_URL_INVALID` без перехода к браузерной сессии или публичному доступу.

**Что делать интеграторам**

Выпустите новый `api-bearer` незаблокированным управляющим ключом и замените токен в клиенте. Повторное обновление прежнего токена не устраняет `KEY_BLOCKED`.

### NEW-1029-7: Рекламные кабинеты сквозной аналитики

Через API можно получать ссылку авторизации, читать и подключать рекламные кабинеты [источника сквозной аналитики](/docs/entities/crm-tracking), отключать кабинет, читать дерево рекламы и выполнять построение отчёта о расходах по одному шагу. Продолжение дерева возвращается курсором. Готовность отчёта определяется полем `complete`.

Методы в процессе раскатки с обновлением `crm 26.2100.0`. Маршруты за флагом `crm-tracking-v3` включатся вместе с возможностью Битрикс24. До включения API отвечает `422 METHOD_NOT_YET_AVAILABLE`.

### NEW-1029-8: Ручные расходы и отчёт по источникам сквозной аналитики

Через API Вайбкод можно добавлять, читать и удалять [ручные расходы](/docs/entities/crm-tracking/expenses-list), а также получать [отчёт по источникам](/docs/entities/crm-tracking/analytics-sources-list). Сумма расходов передаётся в единицах выбранной валюты. Расходы рекламных интеграций этим удалением не затрагиваются.

Методы в процессе раскатки с обновлением `crm 26.2100.0`. Маршруты работают под флагом `crm-tracking-v3` и включатся вместе с возможностью Битрикс24. Пока метод недоступен, ответ — `422 METHOD_NOT_YET_AVAILABLE`.

### FIX-1029-9: повторный вход в Коворк/Код сохраняет прежний ключ до подтверждения нового

**Было**

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

**Стало**

Для десктопа 14.0.94 и новее, передавшего версию и идентификатор установки при начале входа, прежний ключ действует до первого успешного `GET /v1/cowork/me` новым ключом. Предварительные запросы профиля не подтверждают замену. Неподтверждённый ключ остаётся рабочим без отдельного срока действия. Сбой подтверждения не меняет успешный ответ подписки: подтверждение повторяется следующим запросом.

### FIX-1029-10: Временная пауза после повторных отказов доступа к Битрикс24

**Было**

После повторных ответов `401 ACCESS_DENIED` от Битрикс24 запросы с тем же ключом продолжали получать отказы доступа без временной паузы.

**Стало**

После повторных отказов доступа к разным REST-методам запросы к Битрикс24 с этим ключом временно приостанавливаются. Одиночная операция и глобальный `POST /v1/batch`, когда отказ блокирует вызов на уровне конверта, возвращают `429 ERROR_LOOP_DETECTED` с `reason: TEMPORARY_REST_ACCESS_DENIED`; заголовок `Retry-After` и поле `retryAfter` содержат одинаковое число секунд до следующей проверки. Отказ авто-пагинируемого подвызова глобального batch и отказ читающего действия `POST /v1/{entity}/batch` остаются в слоте подвызова при внешнем HTTP `200` и содержат `retryAfter`; у этих ответов нет внешнего `Retry-After`. Отказ пишущего действия entity batch блокирует весь запрос и возвращается конвертом HTTP `429` с `Retry-After` и `retryAfter`. По истечении паузы API автоматически проверяет доступ при следующем запросе. Если доступ восстановлен, запросы возобновляются.

**Затронутые эндпоинты:** публичные операции, которые выполняют REST-вызов Битрикс24 с этим обычным API-ключом, включая [GET /v1/users](/docs/entities/users/list), [POST /v1/batch](/docs/batch) и пакетные операции сущностей. Одиночный вызов и отказ глобального batch на уровне конверта возвращают HTTP 429; отказ авто-пагинируемого подвызова глобального batch и отказ читающего действия entity batch возвращаются в слоте при HTTP 200 с `retryAfter` и без внешнего `Retry-After`. Отказ пишущего действия entity batch возвращает HTTP 429 с внешним `Retry-After` и полем `retryAfter`. Операции без REST-вызова через этот ключ не затрагиваются.

**Влияние на интеграторов**

Изменения интеграции и ручное включение ключа не требуются.
