Shipping Quote API

运费报价 API

这个接口用于输出目的地、货型、重量和尺寸对应的线路报价结果。 这里汇总字段说明、返回结构和接入方式,方便开发者和合作系统快速接入。

接口入口

POST /api/shipping/quote

网站当前通过站内 BFF 暴露统一报价入口。对接时建议同时参考 OpenAPI 规范和运费计算规则页,避免把字段含义解释错位。

请求字段

字段说明
destination目的地代码,如 usa、canada、uk。
cargoType货物类型,如 general、medicine、food、electronics。
weight包裹实际重量(kg)。
dimensions可选尺寸对象,包含 length、width、height(cm)。

返回重点

字段说明
grouped按 air、sea、rail、express 分组的线路数组。
displayVolumeWeight用于前端展示的参考体积重(kg)。
displayBillableWeight用于前端展示的参考计费重(kg)。
route.breakdown首重、续重、续重费、续重单位等计费拆解。
route.promotion匹配到的优惠活动信息。