# 更新日志

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

更新日志格式遵循 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)，
版本号管理遵循 [语义化版本规范](https://semver.org/spec/v2.0.0.html)。

版本：2.1.0

## [2.1.1] - 2026-05-19

### Added

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


## [2.1.0] - 2026-04-09

### Added

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


## [2.0.9] - 2026-01-28

### Added

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


## [2.0.8] - 2026-01-13

### Changed

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


## [2.0.7] - 2025-11-13

### Updated

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


## [2.0.6] - 2025-10-24

### Added

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


## [2.0.5] - 2025-06-23

### Added

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


## [2.0.4] - 2025-06-17

### Added

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


## [2.0.3] - 2025-02-21

### Added

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


### Updated

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


## [2.0.2] - 2024-11-22

### Added

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


## [2.0.1] - 2024-10-30

### Added

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


## [2.0.0] - 2024-10-20

### Added

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


### Updated

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