{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh-Hans/v1/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"更新日志"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"更新日志","__idx":0},"children":["更新日志"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["本文件记录了该项目的所有重要变更。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["更新日志格式遵循 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://keepachangelog.com/en/1.0.0/"},"children":["Keep a Changelog"]},"，"," ","版本号管理遵循 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://semver.org/spec/v2.0.0.html"},"children":["语义化版本规范"]},"。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["版本：2.1.0"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"212---2026-08-25","__idx":1},"children":["[2.1.2] - 2026-08-25"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"changed","__idx":2},"children":["Changed"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/rates/list"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/rates/buy-label"]},"：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["options.hazmat_code"]}," 新增枚举值 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["usps_hazmat_820"]},"，用于寄递 USPS「Class 9 未标记包装的锂电池」。寄往或寄自美国外岛地区（如关岛、波多黎各）的运单，通常需要使用该值才能寄递锂电池。原有 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dhlecs_*"]}," 系列值保持不变。与此前一致，",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hazmat_code"]}," 仅在 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["options.require_hazmat"]}," 为 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," 时生效。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"211---2026-05-19","__idx":3},"children":["[2.1.1] - 2026-05-19"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added","__idx":4},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增西班牙语文档支持，用户可在西班牙语下浏览 ShipSaving API 文档。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"210---2026-04-09","__idx":5},"children":["[2.1.0] - 2026-04-09"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-1","__idx":6},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在快速开始指南中新增可下载的 Postman 合集（ZIP），包含 API 合集及环境文件（Sandbox 和 Production），方便快速测试。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"209---2026-01-28","__idx":7},"children":["[2.0.9] - 2026-01-28"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-2","__idx":8},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增中英文双语文档支持，支持在 ShipSaving API 文档中进行语言切换。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"208---2026-01-13","__idx":9},"children":["[2.0.8] - 2026-01-13"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"changed-1","__idx":10},"children":["Changed"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["将参考表统一迁移至 Legacy API（v1）文档下的独立「Appendix」章节，以明确枚举定义仅适用于 v1 版本。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["废弃顶层 Appendix 页面，并将其保留为",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["兼容性入口"]},"，在不破坏现有链接的前提下，将用户重定向至 Legacy API（v1）Appendix。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"207---2025-11-13","__idx":11},"children":["[2.0.7] - 2025-11-13"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"updated","__idx":12},"children":["Updated"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在附录中新增 UPS Canada 专用的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["service_type"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["predefined_package"]}," 枚举值。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"206---2025-10-24","__idx":13},"children":["[2.0.6] - 2025-10-24"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-3","__idx":14},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/rates/list"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/rates/buy-label"]}," 接口中引入 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["request_id"]}," 参数，用于为每个请求提供唯一标识，便于请求追踪和问题排查。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"205---2025-06-23","__idx":15},"children":["[2.0.5] - 2025-06-23"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-4","__idx":16},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/rates/list"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/rates/buy-label"]}," 接口中新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hazmat_code"]}," 参数，用于支持不同类别的危险品运输。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"204---2025-06-17","__idx":17},"children":["[2.0.4] - 2025-06-17"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-5","__idx":18},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在承运商服务类型表中新增承运商 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GOFO EXPRESS"]}," 及其对应的服务代码。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"203---2025-02-21","__idx":19},"children":["[2.0.3] - 2025-02-21"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-6","__idx":20},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在承运商服务类型表中新增承运商 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Canada Post"]}," 及其对应的服务代码。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"updated-1","__idx":21},"children":["Updated"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/rates/list"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/rates/buy-label"]}," 接口中新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_type"]}," 参数，允许用户指定所需的面单格式。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"202---2024-11-22","__idx":22},"children":["[2.0.2] - 2024-11-22"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-7","__idx":23},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/carrier-account/list"]}," 接口，支持用户获取与其 API 凭证关联的所有承运商账户信息。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"201---2024-10-30","__idx":24},"children":["[2.0.1] - 2024-10-30"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-8","__idx":25},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["新增 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/balance"]}," 接口，用于获取账户的实时美元余额。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"200---2024-10-20","__idx":26},"children":["[2.0.0] - 2024-10-20"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"added-9","__idx":27},"children":["Added"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["发布更新版 API 文档，重点介绍订单管理、运费查询、面单购买与作废、SCAN 表单生成以及账户和承运商访问等核心功能。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/rates/list"]}," 和 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/rates/buy-label"]}," 接口中新增对承运商维度运费查询的支持。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"updated-2","__idx":28},"children":["Updated"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["将 API 基础域名迁移至新的主机环境，以提升性能、可扩展性和安全性。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["对所有接口的错误响应格式进行统一和优化，提升一致性并改善开发者使用体验。"]}]}]},"headings":[{"value":"更新日志","id":"更新日志","depth":1},{"value":"[2.1.2] - 2026-08-25","id":"212---2026-08-25","depth":2},{"value":"Changed","id":"changed","depth":3},{"value":"[2.1.1] - 2026-05-19","id":"211---2026-05-19","depth":2},{"value":"Added","id":"added","depth":3},{"value":"[2.1.0] - 2026-04-09","id":"210---2026-04-09","depth":2},{"value":"Added","id":"added-1","depth":3},{"value":"[2.0.9] - 2026-01-28","id":"209---2026-01-28","depth":2},{"value":"Added","id":"added-2","depth":3},{"value":"[2.0.8] - 2026-01-13","id":"208---2026-01-13","depth":2},{"value":"Changed","id":"changed-1","depth":3},{"value":"[2.0.7] - 2025-11-13","id":"207---2025-11-13","depth":2},{"value":"Updated","id":"updated","depth":3},{"value":"[2.0.6] - 2025-10-24","id":"206---2025-10-24","depth":2},{"value":"Added","id":"added-3","depth":3},{"value":"[2.0.5] - 2025-06-23","id":"205---2025-06-23","depth":2},{"value":"Added","id":"added-4","depth":3},{"value":"[2.0.4] - 2025-06-17","id":"204---2025-06-17","depth":2},{"value":"Added","id":"added-5","depth":3},{"value":"[2.0.3] - 2025-02-21","id":"203---2025-02-21","depth":2},{"value":"Added","id":"added-6","depth":3},{"value":"Updated","id":"updated-1","depth":3},{"value":"[2.0.2] - 2024-11-22","id":"202---2024-11-22","depth":2},{"value":"Added","id":"added-7","depth":3},{"value":"[2.0.1] - 2024-10-30","id":"201---2024-10-30","depth":2},{"value":"Added","id":"added-8","depth":3},{"value":"[2.0.0] - 2024-10-20","id":"200---2024-10-20","depth":2},{"value":"Added","id":"added-9","depth":3},{"value":"Updated","id":"updated-2","depth":3}],"frontmatter":{"seo":{"title":"更新日志"}},"lastModified":"2026-08-26T18:17:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh-hans/v1/changelog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}