帮助中心GitHub

获取运费报价

返回来自多个承运商的某个货件的可用运费报价,并按价格排序。

参数

请求正文

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
ship_date string
发货日期,YYYY-MM-DD,或带时区偏移的 ISO 8601 时间戳(2026-09-12T09:00:00-07:00;带 T 但不带偏移会被拒绝)。依赖星期几的费率(例如周六派送)按它定价。买单时必须把同一个值再传给 POST /v1/labels,报价不会自动带过去。不需要指定未来发货日期时,建议省略这个字段。

返回

200 运费报价计算成功
400 请求数据无效
401 需要身份验证
404 未找到地址

相关

Labels
POST/api/v1/rates