获取运费报价
返回来自多个承运商的某个货件的可用运费报价,并按价格排序。
参数
请求正文
from_address
object
必填
发件地址(ID 或内联 object)
to_address
object
必填
收件地址(ID 或内联 object)
parcel
object
必填
包裹尺寸和重量。准确计算运费所必需。
可以是已有的 parcel ID,也可以是包含尺寸的内联 object。
carrier_account_ids
array
按特定承运商账户 ID 过滤报价(推荐)。
优先级高于 `carriers` 参数。
使用此参数可在系统账户与你的 BYOCA 账户之间进行选择。
可通过 `GET /v1/carrier-accounts` 获取可用账户。
carriers
array
按承运商名称过滤报价(例如 USPS、FEDEX)。
如果提供了 `carrier_account_ids`,则忽略此参数。
注意:如果同一承运商拥有多个账户(系统 + BYOCA),
请改用 `carrier_account_ids` 以实现精确控制。
services
array
按服务过滤报价。两种形式均可接受:
- 服务名称:"Priority Mail"、"UPS Ground"
- 服务代码:"usps_priority"、"ups_ground"
options
object
返回
200
运费报价计算成功
400
请求数据无效
401
需要身份验证
404
未找到地址
相关
Labels
POST/api/v1/rates