Java 兼容桥参考
这个旧的无版本文档链接说明 Java 的三个 API Key 兼容桥接口，不是原 V1 JWT API，也不是新 V2 资源 API。请按现有集成选择对应版本。
开发者 API购买面单
POST
/v1/shipping/buy权限: labels.buy
请求字段
shippingAccountId, rateId | 选中报价返回的承运商账户标识和报价标识。 |
|---|---|
rateRequest | 查价时使用的货件请求，包括地址和包裹信息。 |
clientReferenceId | 你为本次购买设置的稳定引用号。同一笔购买重试时复用此值；新的购买使用新的引用号。 |
返回结果
返回 shipmentId、trackingNumber、shippingCost、insuranceCost、currency，以及可用的 labelBase64 / labelMimeType。在此兼容接口中，shipmentId 是服务商标识，shippingCost / insuranceCost 是服务商成本，不是钱包实扣金额的凭证。多包裹结果可能包含 packages 和 forms。已成功购买的重试会返回原购买记录，不再包含面单字节，请保留首次返回的面单。
响应格式为 { code, message, data }。同时检查 HTTP 状态和响应 code，不要将服务商错误当作购买成功。
必要提醒
此操作会购买真实面单，并可能扣除账户费用。超时后保留相同的 clientReferenceId；首笔结果不确定时不要更换引用号重新购买。无法取回面单时，请先联系支持确认，再决定是否重购。仅收到面单响应不代表钱包已经完成结算。