Nhật ký thay đổi (Changelog)
Chào mừng bạn đến với Nhật ký thay đổi của Nền tảng Netts — tài liệu kỹ thuật toàn diện ghi lại tất cả các cập nhật, cải tiến và tính năng mới được triển khai trên toàn bộ hệ sinh thái Netts.
Phần này cung cấp thông tin chi tiết về:
- Các cải tiến API và endpoint mới
- Tối ưu hóa hiệu năng và cải tiến cơ sở hạ tầng
- Sửa lỗi và các bản cập nhật độ ổn định
- Tính năng mới và các bổ sung chức năng
- Thay đổi phá vỡ tương thích (Breaking changes) và hướng dẫn di chuyển
Tất cả các mục đều được lập tài liệu theo định dạng kỹ thuật chuyên nghiệp với chi tiết triển khai, các thành phần bị ảnh hưởng và thông tin phiên bản.
Các cập nhật mới nhất
Ngày 21 tháng 1 năm 2026 - Giảm giới hạn đơn hàng Energy tối đa
Loại: ⚠️ Thay đổi phá vỡ tương thích (Breaking Change)
Tóm tắt: Đã giảm lượng energy tối đa cho mỗi đơn hàng từ 5.000.000 xuống 3.000.000 đơn vị.
Chi tiết:
- Lượng energy tối đa cho một đơn hàng: 5.000.000 → 3.000.000
- Lượng energy tối thiểu giữ nguyên không đổi: 61.000
- Người dùng cần nhiều hơn 3M energy nên chia thành nhiều đơn hàng
Các thành phần bị ảnh hưởng:
- API: Xác thực dữ liệu endpoint
/apiv2/order1h - Tài liệu: Đơn hàng 1h
Ngày 3 tháng 12 năm 2025 - Endpoint kiểm tra đơn hàng mới
Loại: Tính năng
Tóm tắt: Đã thêm endpoint API mới /apiv2/order_check để truy xuất thông tin chi tiết về các đơn hàng energy 1 giờ.
Chi tiết:
- Lấy thông tin chi tiết đơn hàng bao gồm chi phí, lượng energy, địa chỉ mục tiêu và các hash giao dịch
- Xem thông tin kích hoạt nếu địa chỉ đã được kích hoạt
- Người dùng cha (parent) có thể xem phân tích chi tiết mức chênh lệch giá của người dùng con (subuser) (energy_markup, activation_markup, net_cost)
- Hỗ trợ xác thực quyền sở hữu và kiểm soát truy cập giữa người dùng cha và người dùng con
Các thành phần bị ảnh hưởng:
- API: Endpoint mới
/apiv2/order_check - Tài liệu: Kiểm tra đơn hàng
Ngày 3 tháng 12 năm 2025 - Cải thiện mã trạng thái HTTP tính lũy thừa (Idempotency) & Tối ưu hóa hiệu năng
Loại: Cải tiến
Tóm tắt: Đã cập nhật mã trạng thái HTTP cho các phản hồi tính lũy thừa nhằm cung cấp phản hồi rõ ràng hơn cho các yêu cầu trùng lặp. Đồng thời tối ưu hóa quá trình xử lý pool nội bộ để đạt thời gian phản hồi dưới một giây.
Chi tiết:
Các thay đổi về mã trạng thái HTTP:
- 208 Already Reported - Hiện được trả về khi nhận được một yêu cầu trùng lặp cho một đơn hàng đã được xử lý (trước đây trả về 200)
- 409 Conflict - Hiện được trả về khi một yêu cầu trùng lặp đến trong khi yêu cầu ban đầu vẫn đang được xử lý (trước đây trả về 200)
- Thân phản hồi (Response body) giữ nguyên không đổi - chỉ có mã trạng thái HTTP là khác biệt
Tối ưu hóa hiệu năng:
- Quá trình xử lý đơn hàng từ pool nội bộ hiện hoàn thành trong vòng dưới 1 giây (bao gồm cả kích hoạt địa chỉ)
- Thời gian phản hồi thông thường: 500-700ms cho các đơn hàng từ pool nội bộ
- Phương án dự phòng qua nhà cung cấp bên ngoài vẫn duy trì các đặc tính hiệu năng hiện có
Lý do điều này quan trọng:
- Phân biệt rõ ràng hơn giữa các yêu cầu đầu tiên thành công (200) và các phản hồi được lưu trong bộ nhớ cache/trùng lặp (208/409)
- Client hiện có thể dễ dàng phát hiện các phản hồi trùng lặp bằng cách kiểm tra mã trạng thái HTTP
- Ngăn ngừa sự nhầm lẫn khi nhận được 200 OK cho các yêu cầu đã được xử lý
- Cải thiện tốc độ xử lý để mang lại trải nghiệm người dùng tốt hơn
Các thành phần bị ảnh hưởng:
- API: Endpoint
/apiv2/order1h - Mô-đun xử lý tính lũy thừa (Idempotency)
- Xử lý đơn hàng từ pool nội bộ
Ngày 19 tháng 11 năm 2025 - Cải tiến việc tính toán số dư trong API và Website
Loại: ⚡ Cải tiến
Tóm tắt: Đã cập nhật logic tính toán số dư trong endpoint API /apiv2/userinfo và mục Ví trên website để hiển thị Tổng số dư TRX bao gồm tất cả các giao dịch đang chờ xử lý.
Chi tiết:
Các thay đổi trong API (/apiv2/userinfo):
- Trường
balancetrong phản hồi API hiện trả về Tổng số dư TRX thay vì chỉ có số dư tiền nạp - Tổng số dư TRX bao gồm:
- Số dư ví tiền nạp
- Các khoản thanh toán đang chờ xử lý (Robot & Người dùng con)
- Trừ đi các yêu cầu rút tiền đang chờ xử lý
Các thay đổi trên Website (Mục Ví):
- Cập nhật hiển thị số dư để thể hiện Tổng số dư TRX từ API
- Đơn giản hóa logic frontend - loại bỏ các phép tính trùng lặp
- Thêm chú thích thông tin (tooltip) giải thích các thành phần của số dư
Quan trọng:
- Khoản thanh toán TRX của Robot & Người dùng con được ghi có vào địa chỉ nạp tiền 2 lần mỗi ngày
- Trước khi được ghi có, TRX từ khoản thanh toán của Robot & Người dùng con không thể sử dụng để mua energy
- Để rút TRX/USDT từ khoản thanh toán của Robot & Người dùng con, hãy tích chọn vào hộp kiểm trong biểu mẫu rút tiền
Các thành phần bị ảnh hưởng:
- API: Endpoint
/apiv2/userinfo - Website: Trang Ví (Nạp & Rút tiền)
- Backend: Logic tính toán số dư
Ngày 19 tháng 11 năm 2025 - Khởi tạo Nhật ký thay đổi
Loại: 📚 Tài liệu
Tóm tắt: Khởi tạo ban đầu Nhật ký thay đổi của Nền tảng Netts. Điều này đánh dấu sự bắt đầu của tài liệu kỹ thuật công khai của chúng tôi, nơi chúng tôi sẽ ghi lại tất cả các thay đổi quan trọng, cải tiến và tính năng mới.
Chi tiết:
- Thiết lập cấu trúc nhật ký thay đổi và định dạng tài liệu
- Tạo mục chuyên dụng trên trang tài liệu
- Triển khai hệ thống theo dõi cập nhật theo phiên bản
Mục đích: Cung cấp sự minh bạch và thông tin rõ ràng về quá trình phát triển nền tảng tới người dùng, nhà phát triển và các đối tác tích hợp của chúng tôi.
Lưu trữ
Các bản cập nhật trước đây sẽ được liệt kê tại đây khi chúng diễn ra, được sắp xếp theo ngày theo thứ tự thời gian đảo ngược.
Các danh mục cập nhật
Các bản cập nhật trong nhật ký thay đổi này được phân loại thành:
- 🚀 Feature - Chức năng hoặc khả năng mới
- ⚡ Enhancement - Cải tiến cho các tính năng hiện có
- 🐛 Fix - Sửa lỗi và khắc phục sự cố
- 🔧 Maintenance - Các bản cập nhật cơ sở hạ tầng và hiệu năng
- 📚 Documentation - Các cập nhật và bổ sung tài liệu
- ⚠️ Breaking Change - Các thay đổi có thể yêu cầu cập nhật mã
Nếu có thắc mắc về các bản cập nhật cụ thể hoặc cần hỗ trợ tích hợp, vui lòng liên hệ với đội ngũ kỹ thuật của chúng tôi hoặc tham khảo tài liệu API.