Changelog и версионирование

Версионирование

Версия протокола передаётся в api_version. Совместимые поля могут добавляться без смены версии, поэтому игнорируйте неизвестные поля и не полагайтесь на порядок ключей JSON.

Устаревание

Ломающие изменения публикуются заранее с периодом миграции. WebSocket остаётся WIP и не имеет гарантий совместимости до отдельного объявления.

Текущий MVP

Доступны registry, credentials, webhook с подписью и retry, личные и групповые контексты, отправка/замена сообщений, медиа, кнопки, меню и @echo_bot.

Практика с SDK

Неизвестные JSON-поля нужно игнорировать. Неизвестный type события можно безопасно подтвердить пустым 2xx-ответом и записать в диагностику.

Перед обновлением major-версии SDK сверяйте changelog, прогоняйте тестовые webhook и проверяйте отправку, редактирование, callback и media upload.

// Ignore unknown fields so additive API changes remain compatible.
const { type, data } = event;
if (type === 'message.created') await handleMessage(data);