更新日志

本文件记录了该项目的所有重要变更。

更新日志格式遵循 Keep a Changelog， 版本号管理遵循 语义化版本规范。

版本：2.1.0

• /api/rates/list 和 /api/rates/buy-label：options.hazmat_code 新增枚举值 usps_hazmat_820，用于寄递 USPS「Class 9 未标记包装的锂电池」。寄往或寄自美国外岛地区（如关岛、波多黎各）的运单，通常需要使用该值才能寄递锂电池。原有 dhlecs_* 系列值保持不变。与此前一致，hazmat_code 仅在 options.require_hazmat 为 true 时生效。

• 新增西班牙语文档支持，用户可在西班牙语下浏览 ShipSaving API 文档。

• 在快速开始指南中新增可下载的 Postman 合集（ZIP），包含 API 合集及环境文件（Sandbox 和 Production），方便快速测试。

• 新增中英文双语文档支持，支持在 ShipSaving API 文档中进行语言切换。

• 将参考表统一迁移至 Legacy API（v1）文档下的独立「Appendix」章节，以明确枚举定义仅适用于 v1 版本。
• 废弃顶层 Appendix 页面，并将其保留为兼容性入口，在不破坏现有链接的前提下，将用户重定向至 Legacy API（v1）Appendix。

• 在附录中新增 UPS Canada 专用的 service_type 和 predefined_package 枚举值。

• 在 /api/rates/list 和 /api/rates/buy-label 接口中引入 request_id 参数，用于为每个请求提供唯一标识，便于请求追踪和问题排查。

• 在 /api/rates/list 和 /api/rates/buy-label 接口中新增 hazmat_code 参数，用于支持不同类别的危险品运输。

• 在承运商服务类型表中新增承运商 GOFO EXPRESS 及其对应的服务代码。

• 在承运商服务类型表中新增承运商 Canada Post 及其对应的服务代码。

• 在 /api/rates/list 和 /api/rates/buy-label 接口中新增 label_type 参数，允许用户指定所需的面单格式。

• 新增 /api/carrier-account/list 接口，支持用户获取与其 API 凭证关联的所有承运商账户信息。

• 新增 /api/balance 接口，用于获取账户的实时美元余额。

• 发布更新版 API 文档，重点介绍订单管理、运费查询、面单购买与作废、SCAN 表单生成以及账户和承运商访问等核心功能。
• 在 /api/rates/list 和 /api/rates/buy-label 接口中新增对承运商维度运费查询的支持。

• 将 API 基础域名迁移至新的主机环境，以提升性能、可扩展性和安全性。
• 对所有接口的错误响应格式进行统一和优化，提升一致性并改善开发者使用体验。