更新日志
欢迎访问 Netts 平台更新日志 —— 一份全面的技术日志，记录了整个 Netts 生态系统中实施的所有更新、改进和新功能。
本部分提供以下方面的详细信息：
- API 增强与新端点
- 性能优化与基础设施改进
- 问题修复与稳定性更新
- 新功能与新增特性
- 重大变更与迁移指南
所有条目均以专业的技术格式进行记录，包含实现细节、受影响的组件以及版本信息。
最新更新
2026年1月21日 - 最大 Energy 订单限额降低
类型： ⚠️ 重大变更
概述： 将单笔订单的最大 energy 数量从 5,000,000 降低至 3,000,000 单位。
详情：
- 单笔订单最大 energy：5,000,000 → 3,000,000
- 最小 energy 保持不变：61,000
- 需要超过 300 万 energy 的用户应拆分为多笔订单
受影响的组件：
- API：
/apiv2/order1h端点验证 - 文档：Order 1h
2025年12月3日 - 新增订单查询端点
类型： 功能
概述： 新增了 API 端点 /apiv2/order_check，用于获取 1 小时 energy 订单的详细信息。
详情：
- 获取订单详情，包括费用、energy 数量、目标地址和交易哈希
- 查看地址是否已激活的激活信息
- 主账号用户可查看子用户加价明细（energy_markup、activation_markup、net_cost）
- 支持所有权验证和主子账号访问控制
受影响的组件：
- API：新增
/apiv2/order_check端点 - 文档：Order Check
2025年12月3日 - 改进幂等性 HTTP 状态码与性能优化
类型： 增强
概述： 更新了幂等性响应的 HTTP 状态码，以便为重复请求提供更清晰的反馈。同时优化了内部池处理流程，实现亚秒级响应时间。
详情：
HTTP 状态码变更：
- 208 Already Reported - 现在当收到已处理订单的重复请求时返回（此前返回 200）
- 409 Conflict - 现在当原始请求仍在处理中而收到重复请求时返回（此前返回 200）
- 响应体保持不变 - 仅 HTTP 状态码不同
性能优化：
- 内部池订单处理现在可在 1 秒内完成（包括地址激活）
- 内部池订单的典型响应时间：500-700 毫秒
- 外部提供商回退机制保持现有的性能特征
重要意义：
- 更清晰地区分成功的首次请求（200）与缓存/重复响应（208/409）
- 客户端现在可以通过检查 HTTP 状态码轻松检测重复响应
- 避免因已处理的请求收到 200 OK 而产生混淆
- 提高处理速度，带来更好的用户体验
受影响的组件：
- API：
/apiv2/order1h端点 - 幂等性处理模块
- 内部池订单处理
2025年11月19日 - 增强 API 和网站中的余额计算
类型： ⚡ 增强
概述： 更新了 API 端点 /apiv2/userinfo 和网站钱包部分中的余额计算逻辑，以显示包含所有待处理交易的 Total Balance TRX。
详情：
API 变更（/apiv2/userinfo）：
- API 响应中的
balance字段现在返回 Total Balance TRX，而不仅仅是充值余额 - Total Balance TRX 包含：
- 充值钱包余额
- 待结算款项（Robot 和子用户）
- 减去待处理提现
网站变更（钱包部分）：
- 更新余额显示，以展示来自 API 的 Total Balance TRX
- 简化前端逻辑 - 移除了重复计算
- 添加了说明余额组成部分的信息提示气泡
重要提示：
- Robot 和子用户的结算 TRX 每天 2 次入账至充值地址
- 入账前，Robot 和子用户的结算 TRX 不可用于购买 energy
- 如需提现 Robot 和子用户的结算 TRX/USDT，请勾选提现表单中的复选框
受影响的组件：
- API：
/apiv2/userinfo端点 - 网站：钱包（充值与提现）页面
- 后端：余额计算逻辑
2025年11月19日 - 更新日志初始化
类型： 📚 文档
概述： 首次创建 Netts 平台更新日志。这标志着我们公开技术日志的开始，我们将在其中记录所有重大变更、改进和新功能。
详情：
- 建立了更新日志结构和文档格式
- 在文档站点中创建了专用板块
- 实现了版本化更新跟踪系统
目的： 向我们的用户、开发者和集成合作伙伴提供透明度，并就平台演进进行清晰沟通。
归档
历史更新将在发生后按时间倒序列于此处。
更新类别
本更新日志中的更新分为以下几类：
- 🚀 功能 - 新功能或新特性
- ⚡ 增强 - 对现有功能的改进
- 🐛 修复 - 漏洞修复和错误更正
- 🔧 维护 - 基础设施和性能更新
- 📚 文档 - 文档更新和补充
- ⚠️ 重大变更 - 可能需要更新代码的变更
如对具体更新有任何疑问或需要集成支持，请联系我们的技术团队或参阅 API 文档。