帮助中心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

返回

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

相关

Labels
POST/api/v1/rates
atoship © 2026