{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["img","cards","card","admonition"]},"type":"markdown"},"seo":{"title":"欢迎使用 ShipSaving API","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/api.974655a0667f5054e64e69ac47eef4994324f88208477245d3ffdde348ffd441.c5aff763.png","alt":"Image description","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"欢迎使用-shipsaving-api","__idx":0},"children":["欢迎使用 ShipSaving API"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["无论你是正在成长中的电商品牌、物流合作伙伴，还是正在搭建发货系统的开发团队，"," ","ShipSaving API都可以为你提供灵活、稳定的接口能力，帮助你更高效地完成物流相关操作。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["通过ShipSaving API，你可以统一对接多家主流承运商，包括USPS、UPS、FedEx、DHL Express等，实现创建并购买物流面单，获取并对比实时运费，查询和跟踪物流状态，进行地址校验与规范化，以及更多与发货相关的核心功能。所有能力均通过统一的API接口体系提供，简化系统集成流程，降低对接成本。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"两个-api-版本一个统一的平台能力","__idx":1},"children":["两个 API 版本，一个统一的平台能力"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["为了满足不同用户和系统的对接需求，ShipSaving 目前同时提供两个 API 版本："]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":2,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Legacy API（V1）","image":"/assets/api_v1_bg.f674be32e84601f41c57b4ba8a4c43bbcc88c7b7d9471a645f3e2669d4f1935f.c5aff763.png","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"elevated","to":"/zh-hans/v1"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["已稳定运行多年"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["被大量商家和系统广泛使用"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["覆盖核心的物流与发货功能"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["适合已有系统持续稳定运行"]}]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"New API（v2）","image":"/assets/api_v2_bg.e132bc98c7177b178a1cd4e16d9e56d86e024d82f3b4583f868d02f8a9650908.c5aff763.png","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"elevated","to":"/zh-hans/v2"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["基于全新架构重新设计"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["更高的可扩展性和模块化能力"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["接口结构更清晰，数据更规范"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["提供更好的开发体验，并持续迭代新功能"]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":""},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["我们建议新的系统集成优先使用New API V2，以便获得最新能力和后续功能更新。"," ","同时，Legacy API V1仍会继续维护，确保现有用户和系统的稳定使用。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"core-capabilities","__idx":2},"children":["Core Capabilities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipSaving API提供了一套完整的物流基础能力，可按需单独使用，也可组合使用，构建符合你业务需求的发货流程。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-创建物流面单","__idx":3},"children":["📦 创建物流面单"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["支持快速创建并购买USPS、UPS、FedEx、DHL Express等承运商的物流面单，"," ","覆盖美国本土及国际发货场景，并享受平台提供的折扣价格。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-获取最优运费","__idx":4},"children":["💰 获取最优运费"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["一次请求即可获取多家承运商的实时运费报价，帮助你快速对比不同服务方案，选择性价比最高的发货方式。（支持在未提供完整包裹信息的情况下进行快速运费预览。）"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-物流跟踪","__idx":5},"children":["🚚 物流跟踪"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["随时查询包裹的最新物流状态，也可配置自动化更新机制，及时向你的系统或客户同步物流进展。（Webhook功能即将上线）"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-地址校验","__idx":6},"children":["📍 地址校验"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["在发货前对美国国内地址进行校验和规范化处理，有效减少因地址错误导致的退件、延误或额外费用。"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"开发环境说明","__idx":7},"children":["开发环境说明"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipSaving API提供测试环境（Sandbox）和正式环境（Production），方便你在不同阶段进行开发、测试和上线。"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["不同环境使用独立的API Key"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["使用测试环境Key发起的请求不会产生真实订单或费用"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["建议在测试环境完成调试后，再切换至正式环境"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"需要帮助","__idx":8},"children":["需要帮助？"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["我们的团队将在你接入API的整个过程中提供支持，无论是首次对接、问题排查，还是高级功能的使用，都可以随时联系我们。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["支持方式包括："]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["客户经理支持：直接联系你的专属客户经理或支持群"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["it@shipsaving.com"]}]}]},"headings":[{"value":"欢迎使用 ShipSaving API","id":"欢迎使用-shipsaving-api","depth":2},{"value":"两个 API 版本，一个统一的平台能力","id":"两个-api-版本一个统一的平台能力","depth":3},{"value":"Core Capabilities","id":"core-capabilities","depth":3},{"value":"📦 创建物流面单","id":"-创建物流面单","depth":4},{"value":"💰 获取最优运费","id":"-获取最优运费","depth":4},{"value":"🚚 物流跟踪","id":"-物流跟踪","depth":4},{"value":"📍 地址校验","id":"-地址校验","depth":4},{"value":"开发环境说明","id":"开发环境说明","depth":2},{"value":"需要帮助？","id":"需要帮助","depth":2}],"frontmatter":{"sidebar":{"hide":true},"seo":{"title":"欢迎使用 ShipSaving API"}},"lastModified":"2026-05-13T19:59:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh-hans","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}