Журнал изменений (Changelog)
Добро пожаловать в Журнал изменений платформы Netts — подробный технический журнал, в котором документируются все обновления, улучшения и новые функции, внедренные в экосистеме Netts.
В этом разделе представлена детальная информация о:
- Улучшениях API и новых эндпоинтах
- Оптимизации производительности и обновлениях инфраструктуры
- Исправлениях ошибок и обновлениях стабильности
- Новых функциях и расширении функциональности
- Критических изменениях (breaking changes) и руководствах по миграции
Все записи оформлены в профессиональном техническом формате с описанием деталей реализации, затронутых компонентов и информации о версиях.
Последние обновления
21 января 2026 г. — Снижен максимальный лимит заказа Energy
Тип: ⚠️ Критическое изменение (Breaking Change)
Сводка: Максимальный объем Energy на один заказ снижен с 5 000 000 до 3 000 000 единиц.
Подробности:
- Максимальный объем Energy на один заказ: 5 000 000 → 3 000 000
- Минимальный объем Energy остается без изменений: 61 000
- Пользователям, которым требуется более 3 млн Energy, необходимо разбить заказ на несколько
Затронутые компоненты:
- API: валидация эндпоинта
/apiv2/order1h - Документация: Order 1h
3 декабря 2025 г. — Новый эндпоинт проверки заказа
Тип: Новая функция
Сводка: Добавлен новый эндпоинт API /apiv2/order_check для получения детальной информации о заказах Energy на 1 час.
Подробности:
- Получение деталей заказа, включая стоимость, объем Energy, целевой адрес и хеши транзакций
- Просмотр информации об активации, если адрес был активирован
- Родительские пользователи могут видеть детализацию наценки субаккаунта (energy_markup, activation_markup, net_cost)
- Поддерживает валидацию владельца и контроль доступа между родительским аккаунтом и субаккаунтом
Затронутые компоненты:
- API: новый эндпоинт
/apiv2/order_check - Документация: Order Check
3 декабря 2025 г. — Улучшенные HTTP-коды состояния идемпотентности и оптимизация производительности
Тип: Улучшение
Сводка: Обновлены HTTP-коды состояния для ответов идемпотентности, чтобы обеспечить более понятную обратную связь при повторных запросах. Также оптимизирована обработка во внутреннем пуле, благодаря чему время ответа теперь составляет менее секунды.
Подробности:
Изменения HTTP-кодов состояния:
- 208 Already Reported — теперь возвращается при получении дублирующего запроса для уже обработанного заказа (ранее возвращался 200)
- 409 Conflict — теперь возвращается, если дублирующий запрос поступает в момент, когда исходный заказ еще обрабатывается (ранее возвращался 200)
- Тело ответа остается без изменений — меняется только HTTP-код состояния
Оптимизация производительности:
- Обработка заказов во внутреннем пуле теперь завершается менее чем за 1 секунду (включая активацию адреса)
- Типичное время ответа: 500–700 мс для заказов из внутреннего пула
- Резервное переключение на внешнего провайдера сохраняет прежние характеристики производительности
Почему это важно:
- Более четкое различие между успешными первичными запросами (200) и кэшированными/дублирующими ответами (208/409)
- Клиенты теперь могут легко определять повторные ответы, проверяя HTTP-код состояния
- Исключается путаница при получении 200 OK для запросов, которые уже были обработаны
- Увеличенная скорость обработки улучшает пользовательский опыт
Затронутые компоненты:
- API: эндпоинт
/apiv2/order1h - Модуль обработки идемпотентности
- Обработка заказов внутреннего пула
19 ноября 2025 г. — Улучшенный расчет баланса в API и на сайте
Тип: ⚡ Улучшение
Сводка: Обновлена логика расчета баланса в эндпоинте API /apiv2/userinfo и в разделе «Кошелек» на сайте: теперь отображается Total Balance TRX, включающий все ожидающие транзакции.
Подробности:
Изменения в API (/apiv2/userinfo):
- Поле
balanceв ответе API теперь возвращает Total Balance TRX вместо простого депозитного баланса - Total Balance TRX включает:
- Баланс депозитного кошелька
- Ожидающие выплаты (робот и субаккаунты)
- Минус ожидающие выводы средств
Изменения на сайте (раздел «Кошелек»):
- Отображение баланса обновлено: теперь выводится Total Balance TRX из API
- Упрощена логика фронтенда — удалены дублирующие вычисления
- Добавлена информативная подсказка с объяснением компонентов баланса
Важно:
- Выплаты TRX по роботу и субаккаунтам зачисляются на депозитный адрес 2 раза в день
- До зачисления выплаты TRX по роботу и субаккаунтам не могут быть использованы для покупки Energy
- Чтобы вывести выплаты TRX/USDT по роботу и субаккаунтам, активируйте чекбокс в форме вывода
Затронутые компоненты:
- API: эндпоинт
/apiv2/userinfo - Сайт: страница Кошелька (Депозит и Вывод)
- Бэкенд: логика расчета баланса
19 ноября 2025 г. — Запуск журнала изменений
Тип: 📚 Документация
Сводка: Первоначальное создание журнала изменений платформы Netts. Это знаменует начало ведения нашего публичного технического журнала, где мы будем документировать все значимые изменения, улучшения и новые функции.
Подробности:
- Разработана структура журнала изменений и формат документации
- Создан специальный раздел на сайте документации
- Внедрена версионированная система отслеживания обновлений
Цель: Обеспечить прозрачность и понятное информирование о развитии платформы для наших пользователей, разработчиков и партнеров по интеграции.
Архив
Предыдущие обновления будут публиковаться здесь по мере их появления, в обратном хронологическом порядке.
Категории обновлений
Обновления в этом журнале изменений классифицируются следующим образом:
- 🚀 Новая функция — новая функциональность или возможности
- ⚡ Улучшение — доработки существующих функций
- 🐛 Исправление — исправление багов и устранение ошибок
- 🔧 Обслуживание — обновления инфраструктуры и производительности
- 📚 Документация — обновления и добавления в документации
- ⚠️ Критическое изменение — изменения, которые могут потребовать обновления кода
Если у вас возникли вопросы по конкретным обновлениям или требуется помощь по интеграции, свяжитесь с нашей технической командой или обратитесь к документации по API.