必须是认证企业主体并完成运力接入或SaaS合作才能获取生产权限;PHP需严格按规则生成HmacSHA256签名,注意参数顺序、编码及timestamp/nonce;位置查询受限于司机定位状态;订单状态依赖幂等回调,须验签、去重、快速响应。

怎么拿到滴滴开放平台的 API 权限
没权限就调不通,这是最常卡住的第一步。滴滴开放平台(open.xiaojukeji.com)不支持个人开发者直接申请生产权限,必须是已认证的企业主体,且需完成「运力接入」或「SaaS 合作」流程。
常见错误现象:401 Unauthorized 或 {"code":1001,"msg":"app_key invalid"},基本都是权限没走完。
- 企业需先在滴滴开放平台注册账号,提交营业执照、道路运输经营许可证(如涉及运单)等材料
- 审核通过后,才能创建应用,获取
app_key和app_secret - 测试环境可用沙箱
app_key,但仅支持模拟订单、固定坐标查价,无法调真实司机或定位 - 正式调用
/v1/order/create或/v1/position/query前,必须完成「线上联调」并签署协议
PHP 怎么安全发起带签名的 POST 请求
滴滴所有接口要求 HmacSHA256 签名,且签名字段、顺序、编码规则严格——错一个空格或参数漏 URL 编码,就返回 {"code":1003,"msg":"sign invalid"}。
关键点:签名原文是 app_key=xxx&method=xxx&nonce=xxx×tamp=xxx&v=xxx(按字典序拼接,不含请求体),再拼上 app_secret 做 HmacSHA256,最后 base64 编码。
-
timestamp必须是秒级时间戳,且与滴滴服务器时间偏差不能超过 300 秒 -
nonce每次请求必须唯一(建议用uniqid()),重复会报code:1005 - 请求头必须带
Content-Type: application/json,body 用json_encode(),不能多空格或换行 - 别用
file_get_contents("php://input")自己解析签名——签名验的是原始请求参数,不是 body 解析后的内容
示例片段:
```php
$method = 'POST';
$uri = '/v1/order/create';
$params = [
'app_key' => 'your_app_key',
'method' => $method,
'nonce' => uniqid(),
'timestamp' => time(),
'v' => '1.0'
];
ksort($params);
$sign_str = http_build_query($params, '', '&', PHP_QUERY_RFC3986);
$sign = base64_encode(hash_hmac('sha256', $sign_str, 'your_app_secret', true));
```
调 /v1/position/query 返回空或超时怎么办
这个接口查车辆实时位置,但滴滴不保证每辆车都可查——只有已接单且司机端开启定位上报的车辆才返回有效经纬度;未接单、司机关闭定位、或订单状态非 DRIVING 都会返回空数组或 {"code":2001,"msg":"no position data"}。
- 不要轮询调用,频率限制是 1 次/10 秒/订单,超限直接限流
- 返回
"code":0不代表有位置,要检查data.position是否存在且lat/lng不为 0 - 司机端定位精度差(尤其室内、高架下),返回的
accuracy若大于 50 米,坐标参考价值很低 - PHP cURL 默认 timeout 太短,建议设
CURLOPT_TIMEOUT => 15,否则容易因网络抖动误判失败
订单状态同步为什么总漏掉 ARRIVED 或 FINISHED
滴滴用服务端回调(而非轮询)推送订单状态变更,但 PHP 接收回调时极易出问题:超时、重放、验签失败、并发写库冲突都会导致状态丢失。
- 回调地址必须是公网可访问的 HTTPS 接口,且响应必须在 3 秒内返回
200 OK(不能有 echo/print) - 每次回调带
sign和timestamp,必须用相同规则验签,否则会被当成非法请求丢弃 - 滴滴可能重复推送同一事件(如网络超时重试),需用
event_id做幂等去重,存 Redis 或 DB 加唯一索引 - 别在回调里直接发短信或调第三方 API——失败会导致重推,形成雪崩;应只写 DB + 推消息队列异步处理
真正难的不是调通第一个接口,而是让状态流转在各种异常网络、司机操作、滴滴后台延迟下依然不丢不乱。签名校验、幂等设计、超时控制这三处,漏一个就埋雷。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











