# История изменений

Изменения API, личного кабинета и документации. Даты записей указаны по UTC. Вопросы можно отправить на [support@vilna.io](mailto:support@vilna.io).

5 ноября 2026

Platform API · Management API · VKS

Лимиты ресурсов

added

**Использование ресурсов и лимиты** - Текущие значения и действующие максимумы доступны через API [Platform](/ru/apis/platform#limits), [Management](/ru/apis/mgmt#limits) и [VKS](/ru/apis/vks#limits). Чтение в Platform требует нового права `api:limits:read`; существующие ключи не получают его автоматически.

Platform API

added

**Диапазон сумм в сводке балансов** - В [сводке балансов](/ru/apis/platform/api/balance/summarize-balances) появились необязательные `min_amount` и `max_amount`. Границы включаются в диапазон; значения передаются строками в минимальных единицах актива. `min_amount=1` выбирает известные положительные балансы. Фильтр применяется до пагинации и подсчёта общего количества; неизвестные суммы исключаются.

VKS

improved

**Типизированные действия транзакций** - Параметры транзакции указывают семейство блокчейна и действие, в том числе операции с ресурсами Tron. Ответ содержит нормализованные параметры транзакции. Доступные действия и требования к ним описаны в [справочнике VKS](/ru/apis/vks/api).

29 октября 2026

Platform API · Management API

Права API

improved

**Отдельный доступ к activity** - Для чтения activity в Platform API v2 требуется `api:activity:read`. Списки и детали транзакций по-прежнему используют `api:transaction:read`. Существующие ключи сохранили доступ к activity при введении нового права; для новых ключей эти разрешения выбираются отдельно. См. [Права доступа](/ru/apis/permissions).

improved

**Полномочия Management-ключей** - Management-ключи могут создавать и отзывать API/RPC-ключи в пределах выданных разрешений. Список, чтение, создание и отзыв Management-ключей доступны только через пользовательскую сессию с соответствующими правами в workspace.

28 октября 2026

Platform API

Счета

fixed

**Отмена по учтённым платежам** - Счёт в состоянии `open` или `processing` можно отменить, если среди учтённых действительных платежей нет ожидающих подтверждения, а подтверждённая сумма меньше запрошенной. Подтверждённая частичная оплата не мешает отмене. Если условие отмены не выполнено, API возвращает `422` вместо внутренней ошибки сервера.

improved

**Привязка платежей после отмены** - К отменённому счёту не привязываются новые платежи, в том числе найденные позже с более ранним временем блока. Существующие связи сохраняются, а адрес можно использовать для другого счёта. См. [Отмена счёта](/ru/guides/invoices).

25 октября 2026

Platform API

Счета

improved

**Окно платежей и подтверждения** - Привязка платежа к счёту учитывает время блока. После окончания окна состояние `processing` отделяет незавершённые проверки и ожидание подтверждений от завершённого счёта. Полученная и подтверждённая суммы возвращаются отдельно. См. [Жизненный цикл счёта](/ru/guides/invoices).

22 октября 2026

Platform API

Адреса

fixed

**Сопоставление EVM-адресов** - Переданные в API EVM-адреса нормализуются: регистр букв не мешает сопоставить адрес с его сохранёнными данными.

20 октября 2026

Platform API

Вебхуки

fixed

**Совместимость payload v1** - Каналы с `payload_version: v1` сохраняют прежние идентификаторы сетей и активов. Версия webhook payload не зависит от версии Platform API. См. [Вебхуки](/ru/apis/platform/webhooks).

16 октября 2026

Management API · VKS

Доступ к VKS

added

**Доступ и ключи workspace** - Для VKS используется отдельный ключ workspace с правом `vks:access`. Пользователи с соответствующими полномочиями управляют доступом участников в кабинете; связанные изменения отображаются в истории аудита workspace. См. [Права VKS](/ru/apis/permissions#vks).

12 октября 2026

Platform API · Management API

Лимиты

improved

**Ответы при превышении лимитов** - Platform API v2 и Management возвращают структурированные ответы `429` для квот ресурсов и лимитов действий. Коды ошибок различают исчерпанную квоту и ограничение частоты действий; дальнейшие шаги зависят от указанного лимита. См. [Лимиты и квоты](/ru/apis/errors#rate-limits).

8 октября 2026

Platform API · Management API · VKS

Повторы запросов

added

**Ключи идемпотентности** - Изменяющие запросы Platform API v2, Management и VKS используют `Idempotency-Key` для идентификации операции. Если исход запроса неизвестен, при повторе сохраняйте тот же ключ и параметры; новый ключ означает новое намерение. Сроки хранения результата и порядок восстановления описаны в разделе [Идемпотентность](/ru/apis/idempotency).

24 сентября 2026

Platform API · Документация · Личный кабинет

В этой записи собраны изменения Platform API v2. Справочник описывает `https://api.vilna.io/v2`. Platform API v1 отключается 1 ноября 2026 года; его устаревший справочник останется по адресу [/ru/apis/platform/v1](/ru/apis/platform/v1) после отключения.

Platform API
Документация
Личный кабинет

Platform API

added

**Единая модель блокчейн-данных** - Транзакции используют `chain_gid`, `txid` и `details` выбранного семейства; декодированные события и активность по адресам следуют текущей модели Platform. См. [События](/ru/guides/events).

added

**Балансы по семействам сетей** - Поиск и сводка балансов работают в выбранном семействе. `is_sync` описывает актуальность; неизвестная сумма отсутствует, а не равна нулю. См. [Токены и балансы](/ru/guides/tokens).

added

**Триггеры подписок** - Для каждой подписки выбирают `block`, `network` или Bitcoin `mempool`. Выбор триггера, фильтрация и реорганизации описаны в разделе [События](/ru/guides/events#triggers).

added

**История и восстановление доставки** - История уведомлений содержит попытки доставки и результаты ручной повторной отправки. Каналы показывают своё состояние и лимит попыток. См. [Каналы уведомлений](/ru/guides/channels).

added

**Каталог токенов и доверие** - Метаданные токенов различают поддержку каталога, общую проверку и доверие проекта. См. [Токены и балансы](/ru/guides/tokens).

added

**Сверка счетов** - Жизненный цикл счёта и полученная/подтверждённая суммы - отдельные факты. Частичные оплаты, отмена и публичное представление описаны в руководстве [Счета](/ru/guides/invoices).

added

**Поддержка сетей** - 7 сетей поддерживают полный мониторинг; Solana поддерживает адреса и каталог токенов. Возможности по продуктам приведены в [таблице сетей](/ru/apis/networks).

added

**Симуляция EVM** - Предпросмотр вызовов, событий, изменений балансов и ошибок исполнения без отправки в сеть. См. [Симуляция транзакций](/ru/guides/simulation).

Документация

improved

**Перестроенная структура** - «Начало работы», «Руководства» и «Справочник API» теперь три отдельных раздела, у каждого свой сайдбар и встроенная навигация «назад/далее».

added

**Новая навигация** - мега-меню вверху и индекс [всех руководств](/ru/guides), чтобы найти любое руководство с одного взгляда.

improved

**Все руководства переработаны** - сценарии интеграции, события, каналы уведомлений, счета, симуляция транзакций и интеграция с ИИ теперь с наглядной, легко читаемой вёрсткой.

improved

**Справочник API обновлён** - [Аутентификация](/ru/apis/authentication), [Права доступа](/ru/apis/permissions), [Ошибки](/ru/apis/errors) и [Стандарты](/ru/apis/standards) переписаны с понятными примерами и единой вёрсткой.

added

**Обновление бренда** - новые цвета, типографика и компоненты по всему сайту, с полной поддержкой русского и английского.

added

**Версионный справочник** - v2 используется по умолчанию, а `/v1` остаётся доступен по адресу [/ru/apis/platform/v1](/ru/apis/platform/v1) с переключателем версий в сайдбаре.

added

**Переосмысленная главная** - понятное введение в то, что делает Vilna, с анимированным примером API.

added

**Интерактивный быстрый старт** - изучите фиксированный пример запроса и ответа, затем выполните запрос из своего терминала по руководствам и справочнику. Пример не отправляет запрос и не проверяет ключ.

Личный кабинет

improved

**Переработанный интерфейс** - управление пространствами, проектами, API-ключами и участниками в более чистом и быстром кабинете.

improved

**Обновлённая навигация** в духе нового бренда, со светлой и тёмной темами.

22 февраля 2026

Platform API · Документация

Полная переработка архитектуры платформы и API - первая бета, открытая для интеграции.

Platform API
Документация

Platform API

added

**Основные ресурсы** - первый набор REST-ресурсов: публичные ключи, адреса, транзакции, балансы, токены и каналы уведомлений, с единой пагинацией.

added

**Симуляция EVM** - предпросмотр результата EVM-вызова до отправки в сеть.

improved

**Аутентификация по ключу и лимиты** - каждый вызов аутентифицирован и ограничен по частоте.

Документация

added

**Сайт документации** - первая версия docs.vilna.io с интерактивным справочником API.

added

**Русский и английский** - полная двуязычная поддержка по всей документации.

Инструменты разработчика

added

**Спецификация OpenAPI 3.1** - контракт опубликован в машиночитаемом виде.

added

**Стандарты CAIP и BIP-44** - CAIP-2, CAIP-10 и CAIP-19 для идентификаторов сетей и активов, BIP-44 для путей деривации.

improved

**Вебхуки с повторами** - неудачная доставка повторяется автоматически.

17 сентября 2025

Platform API

Первый прототип платформы с её основными возможностями.

Platform API

added

**Мониторинг транзакций и переводов** - отслеживание транзакций и переводов по мере появления в сети.

added

**HD-кошельки** - генерация кошельков из расширенного публичного ключа, деривация по BIP-44.

added

**Вебхуки и email** - уведомления о событиях в блокчейне, доставляемые как вебхуки или email.

added

**Доступ по запросу** - через [support@vilna.io](mailto:support@vilna.io).