{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/zh-Hans/v1/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","admonition"]},"type":"markdown"},"seo":{"title":"快速开始","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_v1.e46a03a62dc891133c057074c04336ff9e455443a34c46c648e3740488867b08.c5aff763.png","alt":"Image description","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"快速开始","__idx":0},"children":["快速开始"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ShipSaving Legacy API（V1）提供了一套成熟、稳定的物流接口解决方案，可将发货能力直接集成到你的系统或应用中。通过一次对接，你即可在同一平台内完成多家承运商的物流操作，包括获取折扣运费、创建面单、查询物流状态、预约取件等。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Legacy API V1 已长期稳定运行，被大量商家和系统广泛使用，适合对稳定性要求较高、已完成集成或不计划短期升级的业务场景。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"主要功能","__idx":1},"children":["主要功能"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["通过Legacy API（V1），你可以实现以下核心功能："]},{"$$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":["生成 SCAN Form"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["获取账户与承运商信息"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-接入流程说明","__idx":2},"children":["API 接入流程说明"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["根据你的业务系统结构和使用习惯，Legacy API（V1）支持以下几种常见接入方式："]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"-接入方式一","__idx":3},"children":["👍 接入方式一"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["先获取运费，再购买面单。适用于需要在下单前进行运费展示或比价的业务场景。"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["获取运费（Get Rate）"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["购买面单（Buy Label）"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"接入方式二","__idx":4},"children":["接入方式二"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["直接购买面单。适用于业务流程简单、运费规则固定的场景。"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["直接购买面单（Buy Label）"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["限制说明"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["该方式仅适用于账户中只绑定单一类型承运商账号的情况，例如：仅有一个UPS账号；仅有一个FedEx账号；仅有一个USPS账号。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"接入方式三","__idx":5},"children":["接入方式三"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["完整订单流程。适用于希望在 ShipSaving 系统中完整管理订单和物流流程的场景。"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["创建订单（Create Orders）"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["获取运费（Get Rate）"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["购买面单（Buy Label）"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["说明"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["创建订单并非强制要求。如果你已经在自己的系统中管理订单数据，可以仅使用运费查询和面单购买相关接口。"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"postman-合集","__idx":6},"children":["Postman 合集"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["我们提供了开箱即用的 Postman 合集，帮助你快速探索和测试 API。"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"通过 Postman 快速上手"},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["下载并解压下方的 ZIP 文件"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["打开 Postman → 点击左上角 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Import"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["将解压后的 3 个 JSON 文件拖入，或点击 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Choose Files"]}," 选择"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["在右上角环境下拉菜单中选择 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ShipSaving V1 — SANDBOX"]}," 或 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PROD"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["点击环境下拉旁的 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["眼睛图标"]}," → 填入你的 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["apiToken"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["即可开始发送请求"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["下载："]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/assets/shipsaving_legacy_api_v1_postman.6e1aec97ebb50cdf33c1cde06dcedac7d25fa9841f3072505a034cc9fb461546.843036ec.zip"},"children":["ShipSaving Legacy API V1 Postman 合集 (ZIP)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ZIP 包含 API 合集及两个环境文件（Sandbox 和 Production）。"]}]},"headings":[{"value":"快速开始","id":"快速开始","depth":2},{"value":"主要功能","id":"主要功能","depth":3},{"value":"API 接入流程说明","id":"api-接入流程说明","depth":3},{"value":"👍 接入方式一","id":"-接入方式一","depth":4},{"value":"接入方式二","id":"接入方式二","depth":4},{"value":"接入方式三","id":"接入方式三","depth":4},{"value":"Postman 合集","id":"postman-合集","depth":3}],"frontmatter":{"seo":{"title":"快速开始"}},"lastModified":"2026-04-09T22:18:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/zh-hans/v1","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}