Для AI-агентов: markdown этой страницы — /docs-content/changelog/2026-10-30.md индекс документации — /llms.txt

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

← Журнал изменений · Октябрь 2026

NEW-1030-1: различимый отказ для ключа, который не управляет сервером

POST /v1/infra/servers/{id}/start и POST /v1/infra/servers/{id}/refresh возвращают 403 WRONG_KEY, если живой сервер в аккаунте Битрикс24 подтверждённо связан с владельцем ключа или его живым приложением, но управляется другим ключом. Ответ подсказывает перепривязать сервер через пользовательскую сессию. Для чужих, удалённых и неизвестных серверов сохраняется 404 SERVER_NOT_FOUND.

FIX-1030-2: Постраничное чтение содержимого корня хранилища

Было

POST /v1/storages/{id}/children возвращал только первую порцию объектов корня без признака продолжения. Корень с большим числом файлов и папок выглядел как полный список.

Стало

Корректный ответ остаётся HTTP 200: в теле запроса доступны limit от 1 до 500 и offset, а ответ содержит meta.total, meta.hasMore и meta.nextOffset. С тем же фильтром можно дочитать остальные объекты. Если Битрикс24 вернул неполную или недостоверную порцию, операция отвечает 502 DISK_READ_UNAVAILABLE вместо ложного полного списка.

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

Читайте страницы до meta.hasMore: false, передавая meta.nextOffset и прежний фильтр. Обрабатывайте 502 DISK_READ_UNAVAILABLE как отказ чтения: повторите запрос позже.

FIX-1030-3: убывание по id у файлов и папок Диска

Было

GET /v1/files и GET /v1/folders при сортировке по id по убыванию — ?sort=-id или ?order[id]=desc — отдавали записи по возрастанию номера. Ошибки и meta.warnings при этом не было, поэтому запрос «сначала новые файлы» молча приходил в обратном порядке: возрастание по id работало, убывание игнорировалось.

Стало

Убывание по id работает: те же запросы отдают записи от большего номера к меньшему, как на остальных сущностях API. Сортировка по другим полям (name, createdAt) и возрастание по id не изменились.

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

Менять код не нужно. Если выборка «сначала новые» строилась на ?sort=-id, порядок теперь ожидаемый.

FIX-1030-4: событие решения доходит до портала с обновлённым модулем

Было

POST /v1/solution-events отвечал 409 PORTAL_NOT_SUPPORTED на каждое событие, даже когда модуль на портале уже обновлён.

Стало

Событие передаётся порталу с модулем 26.1100.0 и новее. Модуль старше по-прежнему даёт 409 PORTAL_NOT_SUPPORTED, и сообщение называет нужную версию. Отказ портала, когда решение недоступно владельцу карточки, приходит как описано: 409 SOLUTION_NOT_ELIGIBLE, а не 503 PORTAL_UNAVAILABLE.

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

Менять запросы не нужно. События, получившие 409 PORTAL_NOT_SUPPORTED, портал не принимал: их можно отправить заново.

NEW-1030-5: Чаты: открытие обсуждения поста одним вызовом

POST /v1/chats/messages/:messageId/comments/chat открывает чат комментариев поста канала и отдаёт тот же объект, что GET /v1/chats/:dialogId/load: чат, первую страницу сообщений, закреплённые, пользователей и файлы. Принимаются те же параметры messageLimit, pinLimit и ignoreMark; другие параметры и тело запроса отклоняются с 400 INVALID_PARAMS. Если у поста ещё нет чата комментариев, Битрикс24 создаёт его, а вызывающий становится участником, поэтому ключ только для чтения получает 403 WRITE_BLOCKED_READONLY_KEY до обращения к Битрикс24. Вызов не повторяется автоматически. Код отказа Битрикс24 приходит в error.b24Code.

BC-1030-6: регистрация OAuth-ботов и события

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

Было

Новый OAuth-бот мог успешно зарегистрироваться, но последующие вызовы тем же ключом приложения завершались BOT_OWNERSHIP_ERROR. Регистрация webhook на приёмник платформы могла завершиться 201 без свежего подтверждения установки приложения.

Стало

POST /v1/bots регистрирует новый OAuth-бот без передачи botToken и проверяет владельца тем же приложением и точные id/code перед завершением регистрации. Поддерживаются fetch и webhook. Для приёмника платформы нужен свежий подтверждённый INSTALL/placement приложения; без него запрос возвращает 409 BOT_APP_EVENT_ENROLLMENT_REQUIRED. Исторический токен приложения сам по себе не подтверждает установку. Смена botToken нового OAuth-бота отклоняется с 409 BOT_OAUTH_POLICY_INVALID. Боты, зарегистрированные по прежней схеме, сохраняют своё поведение и автоматически не переносятся и не пересоздаются. Правила владения и допуска событий также действуют для PATCH /v1/bots/:botId.

Открытие установленного приложения с корректным токеном приложения и подтверждённым пользователем портала сохраняется при исчерпании лимита необязательного callback-подтверждения, недоступности его проверки, блокировке/мягком удалении автора или неактивном членстве владельца/недействующем связанном ключе. Callback-подтверждение в этих случаях не создаётся и не обновляется. После начала необратимого удаления автора приложение по-прежнему возвращает 403 APP_UNAVAILABLE без выдачи токенов. Подтверждённая принадлежность токена другому OAuth-приложению по-прежнему приводит к отказу.

После восстановления допуска подтверждение снова возможно при следующем открытии. Обязательная проверка пользователя портала и проверка принадлежности при восстановлении токена сохраняются.

Для OAuth-бота приложения перенос владения на личный/webhook-ключ или ключ другого OAuth-приложения (client_id) возвращает 400 TARGET_KEY_INVALID с error.reason=application_mismatch; владелец не меняется. Ключ того же приложения должен пройти остальные проверки допустимости целевого ключа.

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

Если привязка callback приложения меняется во время операции, требующей допуска событий, запрос возвращает 409 BOT_APP_EVENT_CREDENTIAL_CHANGED без Retry-After. Заново подтвердите INSTALL/placement связанного приложения, затем повторите запрос. Этот отказ возможен при регистрации, изменении бота и повторной подписке; он не заменяет правило об отбрасывании удержанных событий при публикации уже подтверждённой идентичности.

Повторная подписка POST /v1/bots/:botId/resubscribe также возвращает OAuth-отказы 409, описанные в OpenAPI; эти отказы не содержат Retry-After.

INSTALL снова принимает верхний DOMAIN, если auth.domain отсутствует или пуст. Оба непустых значения должны совпадать между собой и с сохранённым порталом; конфликт или неверный тип приводит к 403 до внешних вызовов. INSTALL без auth.client_id подтверждается и игнорируется без внешних вызовов и изменения токенов; такой ответ не подтверждает установку. Независимое подтверждение member_id и OAuth-приложения остаётся обязательным для привязки callback. Повторное сохранение тех же OAuth credentials через relink сохраняет подтверждённую привязку callback; реальная смена client_id или secret требует свежего подтверждения. Разные приложения одного автора теперь могут открываться параллельно при необязательной проверке callback.

Приёмник платформы также требует подтверждённого владельца Agent или ManagedBot. Для бота приложения без такого владельца запрос возвращает 409 BOT_APP_EVENT_CONSUMER_REQUIRED до записи в Битрикс24. Публикация подтверждённой идентичности и lifecycle бота продолжается при потере основания для доставки событий; удержанные события при этом отбрасываются. После смены адреса портала удержанные события могут быть доставлены после подтверждённого восстановления идентичности только при неизменной callback-привязке. Если она изменилась или отсутствует, события отбрасываются безвозвратно; восстановление идентичности продолжается. Это не гарантирует доставку каждого события.

Перед новой регистрацией webhook на приёмник платформы установите или откройте placement связанного приложения с подтверждением платформой, затем повторите запрос через Agent или ManagedBot. Для OAuth-бота без такого владельца или связанной установки приложения доступны fetch или собственный приёмник. Для работы с новым OAuth-ботом используйте ключ того же приложения без botToken.

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

Было

Когда операция с уже существующим ботом останавливалась на отказе портала в сохранённых правах — ключ больше не читает бота, старый токен отвергнут, настройки открытой линии недоступны для чтения, — POST /v1/bots и POST /v1/bots/registrations/:code/recover отвечали 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 обрабатывается как прежде.

FIX-1030-8: числовые массивы идентификаторов в описании ответов

Было

OpenAPI описывал элементы User.departmentId, Deal.contactIds и Quote.contactIds как строки, хотя ответы содержат числа. Проверка ответа по такой схеме отклоняла заполненные числовые массивы.

Стало

В схеме ответа эти элементы описаны как числа, в том числе у /v1/users/me. Эндпоинты /v1/users/fields, /v1/deals/fields, /v1/quotes/fields и fieldsDetailed в /v1/guide публикуют отдельное описание readItemSchema: { "type": "number" }. Схемы ввода, принимаемые значения, данные ответа и порядок элементов сохранены; Deal.contactIds остаётся доступным только для чтения.

FIX-1030-9: Суточная бесплатная норма API учитывается по всем ключам владельца

Было

При платном превышении бесплатная норма могла применяться повторно в разных часах и для разных ключей одного владельца в одной компании. Например, две порции по 600 обращений при суточной норме 1000 могли остаться полностью бесплатными.

Стало

Все ключи владельца в одной компании расходуют одну суточную норму, включая обращения, которые ранее были бесплатными. В этом примере оплачиваются 200 обращений сверх нормы. Отзыв существующего ключа не возвращает израсходованную норму, а смена цены не меняет число уже учтённых обращений. Проведённые списания не пересчитываются.

FIX-1030-10: очистка прежнего вебхука больше не закрывает Битрикс24 для подключения Компании

Было

После смены держателя подключения Компании GET /v1/connect/company/status возвращал bitrix_ready: false и reason_code: CONNECTION_WEBHOOK_CLEANUP_PENDING, пока платформа не удалит вебхук прежнего держателя в Битрикс24. Вызовы Битрикс24 по ключу подключения в это время отклонялись с тем же кодом.

Стало

Битрикс24 доступен, как только у подключения есть рабочий вебхук текущего держателя: bitrix_ready от очистки прежних вебхуков не зависит. webhook_cleanup показывает pending, пока очистка идёт, в том числе когда прежний вебхук удалить нечем, и attention_required, когда результат создания вебхука неизвестен. Код CONNECTION_WEBHOOK_CLEANUP_PENDING остаётся для подключения без рабочего вебхука, у которого результат создания вебхука неизвестен.

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

Менять ничего не нужно. Доступность Битрикс24 по-прежнему показывает bitrix_ready.