首页开放平台
免费 100 积分试用 · 注册即领

5 大物流运价 API一行代码接入 TMS / ERP

海运 FCL/LCL、空运、快递、FBA 头程五大类实时运价 —— 用一套 HMAC 签名的 RESTful 接口,把物流巴巴 19 年沉淀的国际物流数据,直接灌到你的业务系统里。

HMAC 签名 + IP 白名单
99.9% 可用
7×24 服务

5 大运价 API + 基础数据

按积分计费,HTTP 5xx 不扣费,签名失败不扣费,超时不扣费 —— 只为成功响应付费。

海运 FCL

1 积分 / 次

整柜运价查询,53 家船公司实时报价,含附加费、船期、有效期。支持按起运港 + 目的港或目的国查询。

海运 LCL

1 积分 / 次

拼箱运价查询,按 W/M 计费,覆盖全球 1200+ 港口,含目的港费用和起运港附加费。

国际空运

2 积分 / 次

6 档分阶段重量报价(45/100/300/500/1000kg),覆盖 1062 个国际机场。

快递专线

3 积分 / 次

DHL / UPS / FedEx / TNT / EMS 等主流国际快递实时报价,含燃油附加费。

FBA 头程

2 积分 / 次

亚马逊 FBA 头程派送实时报价,覆盖美西/美东主要仓库(FTW1/ONT8/LAX9 等),返回对外最终价。

基础数据

免费额度

港口 / 机场 / 船公司 / 航司 / 国家五类字典,中文、英文、标准代码都能查。免费额度内不扣积分,另有常用集可一次性拉取,做下拉框直接用。

5 种语言示例
5 分钟跑通

curl / PHP / Python / Node.js / Java 主流语言开箱即用,复制示例代码 → 替换 AppKey / AppSecret → 立即收到响应。

  • 标准 RESTful JSON + UTF-8
  • HMAC-SHA256 签名(含 body md5 防重放)
  • 服务端时钟容忍 ±5 分钟
  • 签名错误返回 HTTP 403,不扣费
  • 限流返回 HTTP 429(Retry-After 头)
查看完整 API 文档
# 海运 FCL 运价查询
# pol / pod 同时支持三种形态:
#   ① 国际标准代码(5 位)  CNSHA、USLSA      (最快,生产推荐)
#   ② 中文名           上海、洛杉矶        (唯一匹配直接放行)
#   ③ 英文名           shanghai、los angeles
# 同名多港时自动返回各匹配港口的运价(无需重发;传 pod_country 可锁定单一国家)
curl -X POST https://www.5688.cn/api/openapi/v1/freight/fcl/search \
  -H "Content-Type: application/json" \
  -H "X-Awice-AppKey: AK_xxxxxxxxxxxxxxxx" \
  -H "X-Awice-Timestamp: 1731499200" \
  -H "X-Awice-Nonce: a1b2c3d4" \
  -H "X-Awice-Signature: 7f8e9d6c5b..." \
  -d '{"pol":"shanghai","pod":"los angeles","carrier":"MSK"}'

套餐方案 · 按需选择

从免费体验到月度 / 年度不限量包,覆盖个人测试到企业级 ETL 全场景。

体验包

100 积分
¥0免费
  • 注册登录后赠送
  • 全 API 可用
  • 有效期 30 天
  • 在线技术支持
免费领取

入门包

1,500 积分
¥99/ 90 天
  • 个人/小团队偶尔用
  • 全 API 可用
  • 有效期 90 天
  • 在线技术支持
立即购买
推荐

业务包

15,000 积分
¥499/ 180 天
  • 中等团队
  • 全 API 可用
  • 有效期 180 天
  • 工单技术支持
立即购买

专业包

10 万积分
¥1999/ 365 天
  • 中型货代/报价网站
  • 全 API 可用
  • 有效期 365 天
  • 专属客户经理
立即购买
推荐

月度无限包

不限次数
¥3999/ 30 天
  • 高频客户首选
  • 全 API 可用
  • 有效期 30 天
  • 7×24 技术支持 · QPS 优先级
需实名认证(企业/个人任一)
立即购买

季度无限包

不限次数
¥10999/ 90 天
  • 中型公司 / 季度签约首选
  • 全 API 可用
  • 有效期 90 天
  • 7×24 技术支持 · QPS 优先级
需实名认证(企业/个人任一)
立即购买
省 20%

年度无限包

不限次数
¥35999/ 365 天
  • 比月度便宜约 20%
  • 全 API 可用
  • 有效期 365 天
  • 专属对接 + SLA
需实名认证(企业/个人任一)
立即购买

需要更大量或定制 QPS?联系商务定制

为什么选物流巴巴开放平台?

不是冷启动的运价聚合 —— 是 19 年货代真实业务沉淀的实时数据,物流巴巴自家官网和 SaaS 用的就是这套 API。

5
运价 API
1200+
覆盖港口
1062
国际机场
53
船公司
30+
航空公司
4
快递供应商聚合
99.9%
可用率
<100ms
首响应

3 步接入

从注册到第一次成功调用,平均 5 分钟。

01

注册账号

手机号注册物流巴巴账号 → 进入开发者控制台 → 免费领取 100 积分体验包

02

创建应用获取密钥

控制台 → 创建应用 → 获取 AppKey / AppSecret 一组,建议配置 IP 白名单

03

复制代码调用 API

复制下方示例代码 → 替换 AppKey / AppSecret → 直接调用,毫秒级返回

常见问题

还有其他问题?发工单或加微信群,技术团队 24 小时内响应。

查看完整文档
API 调用是按什么计费的?
按「成功响应次数」扣积分(API 字段名 credit)。海运 FCL/LCL 1 积分/次,空运 2 积分/次,FBA 头程 2 积分/次,快递 3 积分/次。HTTP 5xx 服务端错误或签名校验失败不扣费。每个套餐的剩余积分可在控制台实时查看。
字典接口(港口、机场代码)要钱吗?
免费额度内不扣积分。字典是运价查询的配套能力 —— 查运价前总得先把港口解析成代码,所以我们不按次收费。每天的免费额度随套餐等级提升,正常使用碰不到上限;超出后按 1 积分 / 次计费。如果要在自己系统里做港口下拉框,别用搜索接口逐字请求 —— 拉一次「常用字典集」缓存到本地即可,那个接口完全免费、不限次数、也不消耗每日额度。
签名怎么生成?为什么需要签名?
签名采用 HMAC-SHA256(METHOD + 路径 + 时间戳 + 随机串 + body md5)+ AppSecret 计算。请求头放 X-Awice-AppKey / X-Awice-Timestamp / X-Awice-Nonce / X-Awice-Signature。签名 + IP 白名单是防止 AppKey 泄漏被滥用的双重锁。
返回数据是实时的还是缓存的?
海运 FCL/LCL 跟随官网运价同源,由业务团队每日同步;空运、快递运价均由我们自主维护并持续更新。所有响应都返回 update_time 字段,便于你判断数据新鲜度。
QPS 限制是多少?超限怎么办?
免费包 5 QPS,付费次卡 10 QPS,月度无限包 50 QPS,年度无限包 100 QPS。超限返回 HTTP 429(Retry-After 头告知重试时间)。需要更高 QPS 请联系商务定制。
套餐用完之后会自动续费吗?余额怎么扣?
不会自动续费。当前套餐用尽且账户有余额时,可在控制台开启「余额兜底」,按 ¥0.01/积分 自动扣余额继续调用,避免业务中断。如不开启,超限直接返回 HTTP 402 提示购买套餐。
支持哪些数据出口形式?
标准 RESTful JSON,UTF-8 编码。所有金额字段保留 2 位小数(避免浮点精度),所有时间字段返回 Unix 时间戳。出错返回标准 RFC 7807 格式 { code, msg, detail }。
可以提供测试环境吗?
开发者控制台提供「调试沙箱」,免实名、免扣费,可直接发请求验证签名和参数。沙箱仅返回示例数据,正式数据需在生产环境用真实 AppKey 调用。
出现问题怎么联系?
工单系统(控制台→工单)24 小时内响应,付费套餐含专属客户经理对接微信,月度/年度无限包享 7×24 电话支持。

让数据流进你的系统

注册 → 创建应用 → 复制代码 —— 立即开始把物流巴巴的物流数据接进 TMS / ERP / 报价网站。