{"items":[{"type":"link","fsPath":"@l10n/zh-Hans/v2/index.md","metadata":{"type":"markdown"},"label":"首页","link":"/zh-hans/v2","routeSlug":"/zh-hans/v2"},{"type":"group","label":"快速开始","items":[{"type":"link","fsPath":"@l10n/zh-Hans/v2/authentication.md","metadata":{"type":"markdown"},"label":"认证","link":"/zh-hans/v2/authentication","routeSlug":"/zh-hans/v2/authentication"},{"type":"link","fsPath":"@l10n/zh-Hans/v2/integration.md","metadata":{"type":"markdown"},"label":"集成","link":"/zh-hans/v2/integration","routeSlug":"/zh-hans/v2/integration"},{"type":"link","fsPath":"@l10n/zh-Hans/v2/parameterguide.md","metadata":{"type":"markdown"},"label":"参数指南","link":"/zh-hans/v2/parameterguide","routeSlug":"/zh-hans/v2/parameterguide"},{"type":"link","fsPath":"@l10n/zh-Hans/v2/errors.md","metadata":{"type":"markdown"},"label":"错误与限流","link":"/zh-hans/v2/errors","routeSlug":"/zh-hans/v2/errors"}]},{"type":"group","label":"API参考","items":[{"type":"link","label":"ShipSaving New API","link":"/zh-hans/v2/openapi","routeSlug":"/zh-hans/v2/openapi"},{"type":"group","label":"认证与授权","link":"/zh-hans/v2/openapi/认证与授权","routeSlug":"/zh-hans/v2/openapi/认证与授权","items":[{"label":"获取访问令牌","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/认证与授权/getaccesstoken","routeSlug":"/zh-hans/v2/openapi/认证与授权/getaccesstoken","metadata":{"seo":{"title":"获取访问令牌","description":"使用 OAuth 2.1 Client Credentials 授权模式签发一个短期有效的访问令牌。"}},"httpPath":"/oauth2/token"}]},{"type":"group","label":"运单","link":"/zh-hans/v2/openapi/运单","routeSlug":"/zh-hans/v2/openapi/运单","items":[{"label":"批量快速报价","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/运单/batchquickrate","routeSlug":"/zh-hans/v2/openapi/运单/batchquickrate","metadata":{"seo":{"title":"批量快速报价","description":"该接口允许通过提供 from_address_data、to_address_data、package_data 和 ship_date 快速获取运单运费报价。"}},"httpPath":"/api/shipment/batch/quick_rate"},{"label":"查询报价","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/运单/getrates","routeSlug":"/zh-hans/v2/openapi/运单/getrates","metadata":{"seo":{"title":"查询报价","description":"获取你账户下所有启用的承运商及服务等级的运费报价，并可按指定的承运商和服务等级进行可选筛选。返回结果将按照最快、最便宜等条件进行排序，同时包含适用的错误信息（如有）。"}},"httpPath":"/api/shipment/get_rates"},{"label":"购买运单","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/运单/createandpay","routeSlug":"/zh-hans/v2/openapi/运单/createandpay","metadata":{"seo":{"title":"购买运单","description":"使用先前 get_rates 接口返回的 rate_id 创建并支付运单面单。该接口还支持在同一次请求中购买运单保险（保险不可单独购买）。"}},"httpPath":"/api/shipment/create_and_pay"},{"label":"直接购买运单","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/运单/directbuy","routeSlug":"/zh-hans/v2/openapi/运单/directbuy","metadata":{"seo":{"title":"直接购买运单","description":"无需单独调用 get_rates 接口，即可一步完成运单面单的创建与购买。"}},"httpPath":"/api/shipment/direct_buy"},{"label":"作废运单","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/运单/voidlabel","routeSlug":"/zh-hans/v2/openapi/运单/voidlabel","metadata":{"seo":{"title":"作废运单","description":"该接口支持通过 以下任一方式 作废运单面单：shipment_no 或 platform_uk_id。仅需提供其中一个参数即可唯一标识一条运单。"}},"httpPath":"/api/shipment/void_label"},{"label":"查询保险报价","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/运单/paths/~1api~1shipment~1insurance~1rate/get","routeSlug":"/zh-hans/v2/openapi/运单/paths/~1api~1shipment~1insurance~1rate/get","metadata":{"seo":{"title":"查询保险报价","description":"查询保险报价"}},"httpPath":"/api/shipment/insurance/rate"}]},{"type":"group","label":"物流轨迹","link":"/zh-hans/v2/openapi/物流轨迹","routeSlug":"/zh-hans/v2/openapi/物流轨迹","items":[{"label":"通过运单号查询物流状态（包含UTC偏移量）","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/物流轨迹/getshipmenttrackingwithutcoffset","routeSlug":"/zh-hans/v2/openapi/物流轨迹/getshipmenttrackingwithutcoffset","metadata":{"seo":{"title":"通过运单号查询物流状态（包含UTC偏移量）","description":"获取承运商上报的当前运单追踪事件、首次扫描事件以及完整的物流追踪事件历史。"}},"httpPath":"/api/shipment/direct/tracking_by_tracking_no"},{"label":"提交 Proof of Delivery（签收凭证）","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/物流轨迹/submitpod","routeSlug":"/zh-hans/v2/openapi/物流轨迹/submitpod","metadata":{"seo":{"title":"提交 Proof of Delivery（签收凭证）","description":"为已送达的运单提交 Proof of Delivery（签收凭证）请求。目前仅支持 USPS（carrier_code = USPS），其他承运商会返回业务错误。"}},"httpPath":"/api/shipment/submit_pod"}]},{"type":"group","label":"预约取件","link":"/zh-hans/v2/openapi/预约取件","routeSlug":"/zh-hans/v2/openapi/预约取件","items":[{"label":"预约取件","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/预约取件/addpickupbyshipment","routeSlug":"/zh-hans/v2/openapi/预约取件/addpickupbyshipment","metadata":{"seo":{"title":"预约取件","description":"使用已有的发货信息创建 USPS 承运商取件请求。该接口会安排 USPS 快递员在下一个 USPS 投递日上门取走符合条件的包裹。该接口可能返回的全部错误码，请参见附录 — 预约取件错误码。"}},"httpPath":"/api/shipment/pickup/add"},{"label":"取消预约取件","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/预约取件/cancelpickup","routeSlug":"/zh-hans/v2/openapi/预约取件/cancelpickup","metadata":{"seo":{"title":"取消预约取件","description":"取消先前已预约的承运商取件。取件一旦被取消，将无法再次更新或取消。该接口除 pickup_no 外不需要提供任何其他参数。取消成功后，取件状态将变更为 CANCELED。该接口可能返回的全部错误码，请参见附录 — 预约取件错误码。"}},"httpPath":"/api/shipment/pickup/cancel"},{"label":"查询历史预约取件记录","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/预约取件/getpickuplist","routeSlug":"/zh-hans/v2/openapi/预约取件/getpickuplist","metadata":{"seo":{"title":"查询历史预约取件记录","description":"获取系统中已创建的取件记录分页列表。该接口支持按USPS确认号、取件状态以及承运商代码等条件进行可选筛选。分页参数（page和page_size）用于控制返回数据集的大小，order_by参数用于指定结果的排序方式。"}},"httpPath":"/api/shipment/pickup/list"},{"label":"查询包裹位置","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/预约取件/getpackagelocation","routeSlug":"/zh-hans/v2/openapi/预约取件/getpackagelocation","metadata":{"seo":{"title":"查询包裹位置","description":"返回有效的包裹放置位置枚举值列表。这些枚举值用于指示在预约取件时，包裹将被放置在取件地址的具体位置，供USPS邮政投递员上门取件。"}},"httpPath":"/api/shipment/pickup/package/location/list"}]},{"type":"group","label":"地址验证","link":"/zh-hans/v2/openapi/地址验证","routeSlug":"/zh-hans/v2/openapi/地址验证","items":[{"label":"地址验证","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/地址验证/validateaddress","routeSlug":"/zh-hans/v2/openapi/地址验证/validateaddress","metadata":{"seo":{"title":"地址验证","description":"地址校验接口用于校验美国国内地址的有效性，并按照 USPS® 地址规范返回标准化后的地址组成部分。该API有助于提升投递准确率、减少无法投递的包裹，并为物流与运费计算提供一致且可靠的地址基础。"}},"httpPath":"/api/address/validate"}]},{"type":"group","label":"SCAN Form","link":"/zh-hans/v2/openapi/scan-form","routeSlug":"/zh-hans/v2/openapi/scan-form","items":[{"label":"创建 SCAN Form","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/zh-hans/v2/openapi/scan-form/createscanform","routeSlug":"/zh-hans/v2/openapi/scan-form/createscanform","metadata":{"seo":{"title":"创建 SCAN Form","description":"为一组已购买的运单创建 USPS SCAN Form（PS Form 5630），并返回生成的清单 PDF 的 URL。SCAN Form 是一张把多个运单合并到一起的清单条码，承运商在揽收时扫描这一张即可一次性接收整批运单。"}},"httpPath":"/api/scan_form/create_scan_form"}]}]},{"type":"link","fsPath":"@l10n/zh-Hans/v2/changelog.md","metadata":{"type":"markdown"},"label":"更新日志","link":"/zh-hans/v2/changelog","routeSlug":"/zh-hans/v2/changelog"},{"type":"link","fsPath":"@l10n/zh-Hans/v2/appendix.md","metadata":{"type":"markdown"},"label":"附录","link":"/zh-hans/v2/appendix","routeSlug":"/zh-hans/v2/appendix"}]}