SDK 下载

当前我们暂未发布封装 SDK,但已提供完整的多语言签名工具函数和接口示例代码。这是 有意为之 —— 物流巴巴 OpenAPI 设计极简(4 个请求头 + 1 行签名),客户大多 5 分钟就能在自己项目里写好封装。

可用

PHP 示例代码

完整 HMAC-SHA256 签名 + curl 调用示例,复制即可运行。可直接封装为内部 SDK。

查看完整 PHP 代码
可用

Python 示例代码

基于 requests + hmac 标准库的签名工具函数和接口调用示例。

查看 Python 签名工具函数
可用

Node.js 示例代码

基于 crypto + https 内置模块的签名工具函数,可在 Node 12+ 直接运行。

查看 Node 签名工具函数
可用

Go 示例代码

使用 crypto/hmac + crypto/sha256 标准库的签名工具结构体,可直接复制到项目中。

查看 Go 签名工具函数
即将发布

官方 PHP SDK Composer 包

基于 Guzzle HTTP 的官方 PHP SDK,含自动签名、重试、限流退避,计划 v1.0 发布。

请关注物流巴巴公众号获取发布通知
即将发布

官方 Python SDK pip 包

基于 httpx 的官方 Python SDK,含异步调用、自动重试,计划 v1.0 发布。

请关注物流巴巴公众号获取发布通知
敬请期待

Postman 集合

导入即可调用全部接口,含 Pre-request Script 自动计算签名,无需手写。

请关注物流巴巴公众号获取发布通知
可用

在线调试器

免实名免扣费的沙箱调试工具,可在浏览器中直接调用所有接口验证签名。

进入在线调试器

关于官方 SDK 计划

我们计划在 2026 年下半年发布 PHP / Python 两个语言的官方 SDK,特性包括:

  • 自动签名(仅传 AppKey/AppSecret 一次)
  • 自动重试 + 指数退避(4xx/5xx 智能区分)
  • 限流自动退避(消费 Retry-After 头)
  • 类型化的接口定义和响应模型
  • 内置请求 ID 追踪日志
  • Composer / pip 包管理

如果你希望优先支持 Java / Go / .NET / Ruby 等语言 SDK,欢迎在 联系我们 页面提交需求投票。

推荐学习路径

  1. 先看 快速接入 页面,复制 PHP 完整示例,跑通第一次调用
  2. 再看 鉴权 & 签名 页面,理解签名算法,把示例改造为你的项目内部封装
  3. 需要哪个接口就查哪个文档:FCL/LCL/AIR/EXPRESS
  4. 出错对照 错误码大全 定位问题,仍有疑问发工单(附 request_id)
SDK 下载 - 物流巴巴开放平台文档 | 5688.cn