API方法
方法列表
| 方法名 | 说明 | 支持版本 |
|---|---|---|
| getEstimateTime | 获取预估接驾时间 | >=1.0 |
| getEstimatePrice | 获取预估费用 | >=1.0 |
| getCurrentOrderStatus | 获取当前订单状态 | >=1.0 |
| getCurrentDriverInfo | 获取当前订单司机信息 | >=1.0 |
| getOrderList | 获取行程列表 | >=1.0 |
| getPoi | 获取坐标位置 | >=1.0 |
| register | 注册用户id | >=1.0 |
| callApp | 调起滴滴APP端 | >=1.0 |
| newOrder | 请求行程 | >=2.1 |
| cancelOrder | 取消行程 | >=2.1 |
| getBill | 获取账单 | >=2.1 |
| getProduct | 获取运力类型 | >=2.1 |
| bindDevice | 绑定扩展设备 | >=2.2 |
| unbindDevice | 解绑扩展设备 | >=2.2 |
通用接口返回格式
{
"errno": 0, // 错误码，0正常，否则异常
"errmsg": "", // 错误信息，errno = 0时为空，errno != 0时为错误的描述信息
"data": {
// 实际接口的返回数据
}
}
一些常见的常量
| 参数名 | 说明 | 版本支持 |
|---|---|---|
| biz | 业务线id，1：出租车；2：专车；3：快车；4：顺风车；5：代驾。 | < 2.0 |
| car_type | 车型列表，2：专车舒适型；4：专车豪华型；16：专车商务型；64：快车普通型 | < 2.0 |
| product_type | 产品业务线列表，代替biz | >= 2.0 |
| ride_type | 车型列表，代替car_type | >= 2.0 |
| maptype | 地图坐标类型，默认soso，支持类型见备注 | >= 1.0 |
注意
为了支持更丰富和统一的API操作，新文档API方法接口参数和结果有变化，在线文档只维护新版本（2.0.0）更新后的参数和结果，旧版本（version < 2.0.0）相关请参照之前的接入方已有的离线接口文档，建议更新SDK的版本来获得更丰富的操作和更稳定的服务。以下是对旧版本（version < 2.0.0）的一些说明
- 传参和结果中的biz，cartype在2.0.0及以后版本将不再支持使用，对应的替换为product_type，ride_type字段（部分接口传参由product字段的json值包裹）来确定具体产品类型，详情可参考3.11getProduct部分车型关系说明
- 返回字段中行程状态字段值更新，舍弃status_name文案字段，如 getCurrentOrderStatus返回由 "status": "wait_strive", "status_name": "等待抢单" 改为 "status": "Pending"，行程状态字段含义如说明
- 传参和结果中的字段名命名风格更改，一些字段名新增了下划线，字段含义不变
行程状态
| 行程状态 | 含义 |
| Pending | 行程已被接受，派单中 |
| Accepted | 司机已接单 |
| Arrived | 司机已到达接驾地点 | Charging | 乘客上车，司机计费 |
| Finished | 到达目的地，行程结束 |