开放API，2小时快速对接

RESTful接口 · 多语言SDK · 完善文档 · 技术支持全程陪伴

POST /v1/order/create

// 请求示例
{
  "sender": {"name": "张三", "phone": "13800138000"},
  "receiver": {"name": "李四", "phone": "13900139000"},
  "weight": 1.5
}

// 返回结果
{
  "code": 200,
  "order_id": "QB20260602001",
  "carrier": "中通快递",
  "price": 6.50
}

API 产品

丰富的API产品

已开放的核心接口，更多能力持续迭代中

下单API

已上线

一键下单，自动匹配最优快递。支持多家快递公司比价，自动选择性价比最高的配送方案。

核心参数：发件地址收件地址重量尺寸

查看详情 →

地址解析API

已上线

自动识别非结构化地址，解析为标准的省、市、区、详细地址结构化数据。

核心参数：自由文本地址 → 结构化省市区

查看详情 →

物流查询API 统一查询多家快递物流状态，一个接口获取所有快递公司的物流轨迹信息。即将上线

电子面单API 生成电子面单并打印，支持多家快递公司面单模板，对接热敏打印机直接打印。即将上线

物流追踪推送API 物流状态变更实时推送，通过Webhook主动通知订单状态变化，无需轮询。即将上线

代码示例

多语言SDK，开箱即用

提供 Python / Java / Node.js / PHP 四种语言的SDK和调用示例

import requests

url = "https://api.qbida.com/v1/order/create"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "sender": {"name": "张三", "phone": "13800138000", "address": "厦门市思明区xxx"},
    "receiver": {"name": "李四", "phone": "13900139000", "address": "北京市朝阳区xxx"},
    "weight": 1.5,
    "service_type": "standard"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

OkHttpClient client = new OkHttpClient();
MediaType JSON = MediaType.parse("application/json");
String json = "{\"sender\":{\"name\":\"张三\",\"phone\":\"13800138000\"},"
    + "\"receiver\":{\"name\":\"李四\",\"phone\":\"13900139000\"},"
    + "\"weight\":1.5}";
Request request = new Request.Builder()
    .url("https://api.qbida.com/v1/order/create")
    .addHeader("Authorization", "Bearer YOUR_API_KEY")
    .post(RequestBody.create(JSON, json))
    .build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());

const axios = require('axios');

async function main() {
  const response = await axios.post('https://api.qbida.com/v1/order/create', {
    sender: { name: '张三', phone: '13800138000', address: '厦门市思明区xxx' },
    receiver: { name: '李四', phone: '13900139000', address: '北京市朝阳区xxx' },
    weight: 1.5,
    service_type: 'standard'
  }, {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  });

  console.log(response.data);
}

main();

<?php
$client = new GuzzleHttp\Client();
$response = $client->post('https://api.qbida.com/v1/order/create', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => [
        'sender' => ['name' => '张三', 'phone' => '13800138000'],
        'receiver' => ['name' => '李四', 'phone' => '13900139000'],
        'weight' => 1.5,
        'service_type' => 'standard'
    ]
]);
echo $response->getBody();