Журнал змін
Ласкаво просимо до Журналу змін платформи Netts — вичерпного технічного журналу, у якому документуються всі оновлення, покращення та нові функції, реалізовані в екосистемі Netts.
Цей розділ містить детальну інформацію про:
- Покращення API та нові кінцеві точки
- Оптимізацію продуктивності та вдосконалення інфраструктури
- Виправлення помилок та оновлення стабільності
- Нові можливості та додану функціональність
- Зміни, що порушують зворотну сумісність, та посібники з міграції
Усі записи оформлено у професійному технічному форматі із зазначенням деталей реалізації, зачеплених компонентів та інформації про версії.
Останні оновлення
21 січня 2026 р. - Знижено максимальний ліміт замовлення Energy
Тип: ⚠️ Зміна, що порушує сумісність
Короткий зміст: Максимальну кількість 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 для отримання детальної інформації про 1-годинні замовлення Energy.
Деталі:
- Отримання деталей замовлення, включно з вартістю, обсягом 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 та в розділі Гаманець на вебсайті, щоб відображати Загальний баланс TRX, який включає всі незавершені транзакції.
Деталі:
Зміни в API (/apiv2/userinfo):
- Поле
balanceу відповіді API тепер повертає Загальний баланс TRX замість лише депозитного балансу - Загальний баланс TRX включає:
- Баланс депозитного гаманця
- Очікувані виплати (Робот і Субкористувачі)
- Мінус очікувані виведення
Зміни на вебсайті (Розділ «Гаманець»):
- Оновлено відображення балансу для показу Загального балансу TRX з API
- Спрощено фронтенд-логіку — видалено дублюючі розрахунки
- Додано інформативну підказку, що пояснює складові балансу
Важливо:
- TRX виплат Робота та Субкористувачів зараховуються на депозитну адресу двічі на день
- До моменту зарахування TRX виплат Робота та Субкористувачів не можна використовувати для купівлі Energy
- Щоб вивести TRX/USDT виплат Робота та Субкористувачів, позначте відповідний чекбокс у формі виведення
Зачеплені компоненти:
- API: кінцева точка
/apiv2/userinfo - Вебсайт: сторінка Гаманець (Депозит і Виведення)
- Бекенд: логіка розрахунку балансу
19 листопада 2025 р. - Запуск Журналу змін
Тип: 📚 Документація
Короткий зміст: Створення Журналу змін платформи Netts. Це знаменує початок ведення нашого публічного технічного журналу, де ми фіксуватимемо всі суттєві зміни, покращення та нові функції.
Деталі:
- Сформовано структуру журналу змін і формат документації
- Створено виділений розділ на сайті документації
- Впроваджено систему відстеження оновлень за версіями
Призначення: Забезпечення прозорості та чіткої комунікації щодо розвитку платформи для наших користувачів, розробників та партнерів з інтеграції.
Архів
Попередні оновлення відображатимуться тут у міру їх появи, впорядковані за датою у зворотному хронологічному порядку.
Категорії оновлень
Оновлення у цьому журналі змін розподілено за такими категоріями:
- 🚀 Feature — нова функціональність або можливості
- ⚡ Enhancement — покращення наявних функцій
- 🐛 Fix — виправлення помилок та збоїв
- 🔧 Maintenance — оновлення інфраструктури та продуктивності
- 📚 Documentation — оновлення та доповнення документації
- ⚠️ Breaking Change — зміни, що можуть вимагати оновлення коду
З питаннями щодо конкретних оновлень або за підтримкою з інтеграції звертайтеся до нашої технічної команди чи переглядайте документацію API.