滴滴 API
  1. OpenAPI
滴滴 API
  • 简介
  • OpenAPI
    • 接入前必读
    • 环境说明
    • 状态回调
    • 获取接入方用户信息
    • 安全认证
      POST
    • 扩展设备绑定验证
      POST
    • POI地址服务
      GET
    • 运力类型
      GET
    • 计价规则
      GET
    • 周边司机
      GET
    • 预估时间(ETA)
      GET
    • 预估价格
      GET
    • 发单预校验接口
      POST
    • 请求行程
      POST
    • 等待司机响应
      GET
    • 发单后修改行程
      PUT
    • 取消行程
      PUT
    • 司机位置
      GET
    • 行程详情
      GET
    • 账单
      GET
    • 评价司机
      POST
    • 司机号码解密
      GET
    • 申请发票
      POST
    • 发票查询
      GET
    • 电子发票预览
      GET
    • 电子发票重发
      GET
    • 服务器状态查询
      GET
    • 支付状态检查
      GET
    • 支付接口
      POST
    • 机场信息接口
      GET
    • 呼端链接
      GET
    • openCoupon
      POST
    • couponInfo
      POST
    • 顺风车
      GET
    • 线下测试环境司机自动化接单
      GET
    • 司乘重联
      POST
    • 取消规则
      GET
  • 备注
    • 接入频次控制等级
    • 行程状态推送支持类型
    • 状态机(专车,快车)
    • 费用列表(专车,快车)
    • 错误码(持续更新)
    • 滴滴开放平台服务器ip列表
    • 其他
  • 安全
    • 用户访问滴滴H5凭证
    • 获取用户封禁信息
    • 录音录像授权结果查询
    • 录音录像授权
    • 紧急联系人查询
    • 紧急联系人操作
    • 安全中心面板-获取报警信息
    • 获取报警信息
    • 触发一键报警
  1. OpenAPI

请求行程

正式环境
https://api.xiaojukeji.com/
正式环境
https://api.xiaojukeji.com/
POST
/v1/orders
功能: 根据起点、终点、运力类型,创建行程
支持运力: 所有,各车型接入均需申请
注: 默认为soso坐标系,坐标必须精确到小数点后6位,可以使用接口文档中的poi功能接口
拦截相关错误码:
录音授权拦截
{
    "error":"code(62003)",
    "error_detail":"请进行录音授权"
}
录音录像授权拦截
{
    "error":"code(62004)",
    "error_detail":"请进行录音、录像授权"
}
封禁拦截
{
    "error":"code(62005)",
    "error_detail":"封禁拦截"
}
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.xiaojukeji.com//v1/orders' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{"oid":"1234567890",product":{"product_type":"private-car","ride_type":"compact"},"origin":{"lng":116.312615,"lat":40.058922,"name":"西二旗地铁站","address":"上地十街"},"destination":{"lng":116.344434,"lat":39.998568,"name":"五道口购物中心","address":"成府路"},"passenger":{"phone":"13900000000","name":"Will","lng":116.312615,"lat":40.058922},"device":{"time":"2016-03-01T10:00:00+0800","imei":"123aswdwe1235","suuid":"123juuiuiausd"},"departure_time":"2016-03-01T10:00:00+0800","create_time":"2016-03-01T10:00:00+0800","estimate_id":"asdasdasdad","map_type":"wgs","risk_info":{"pay_type":"baidu","time":"2016-03-01T10:00:00+0800","lng":116.344434,"lat":39.998568,"deviceid":"asdfkwhfmd","ip":"127.0.0.1","wifi_mac":"asdqweert"},"card_info":{"card_id":"1234567890","people_id":"123asdqwe","ip":"127.0.0.1","wifi_mac":"asdqweert","imei":"qweasdrt123","deviceid":"qweasdrt123","status":"1","channel":"baidu","source":"webapp","time":"2016-03-01T10:00:00+0800","lng":116.344434,"lat":39.998568},"login_info":{"ip":"127.0.0.1","imei":"qweasdrt123","deviceid":"qweasdrt123","wifi_mac":"asdqweert","time":"2016-03-01T10:00:00+0800","lng":116.344434,"lat":39.998568}}}'
响应示例响应示例
{
    "oid": "string",
    "didi_oid": "string",
    "status": "string",
    "product_type": "string",
    "ride_type": "string"
}

请求参数

Header 参数
Authorization
string 
必需
默认值:
Bearer domain|{{access_token}}
Body 参数application/json
oid
string 
必需
接入方订单id,必须提供,防止重复发单,每个用户(手机号)默认只能有一个进行中(即计费中)的行程
product
object 
必需
必须包含产品类型和运力类型
product_type
string 
产品类型
必需
ride_type
string 
运力类型
必需
origin
object 
用车出发地信息
必需
lng
number 
经度
必需
lat
number 
纬度
必需
name
string 
地名
必需
address
string 
地址
可选
destination
object 
用车目的地信息
必需
lng
number 
经度
必需
lat
number 
纬度
必需
name
string 
地名
必需
address
string 
地址
可选
passenger
object 
必需
乘客相关数据,电话,姓名(可选),当前位置坐标(平台接入时可选)
phone
string 
手机号
必需
name
string 
姓名
可选
lng
number 
可选
经度(接入滴滴反作弊时必须)
lat
number 
可选
纬度(接入滴滴反作弊时必须)
device
object 
设备信息
必需
time
string 
必需
imei
string 
必须至少提供一个
必需
suuid
string 
必需
和imei必须至少提供一个
deviceid
string 
可选
network
string 
可选
(可选,wifi/2G/3G/4G)
ip
string 
必需
设备ip地址(接入滴滴反作弊时必须)
wifi_name
string 
可选
network为wifi时必填
wifi_ip
string 
必需
network为wifi时必填
wif_mac
string 
必需
network为wifi时必填
departure_time
string 
可选
用户选择的出行时间,默认为当前时间(即实时用车)。支持ISO8601格式和timestamp格式
create_time
string 
可选
可选,接入滴滴反作弊时必须) 用户请求接入方服务的时间,默认为当前时间,支持ISO8601格式和timestamp格式 2016-03-01T10:00:00+0800
estimate_id
string 
必需
费用预估id,有效时间2分钟用户使用滴滴非出租车服务必须先预估行程费用,此id在预估价格时下发,必须在请求行程时上传,用户请求行程时候的信息和预估时候的信息必须一致,出行时间与预估时候的时间误差不得大于5分钟
map_type
string 
必需
坐标系类型,默认soso,支持坐标系见备注
risk_info
object 
必需
风控数据信息(接入滴滴反作弊时必须),若乘客已预支付,则在订单完成后将按预付费用与司机结算;否则,将等待接入方确认乘客支付后再付款给司机
pay_type
string 
必需
time
string 
必需
lng
number 
必需
lat
number 
必需
deviceid
string 
必需
ip
string 
必需
wifi_mac
string 
必需
card_info
object 
必需
[ card_id, people_id, time, ip, imei, deviceid, lat, lng, status, channel, source, wifi_mac]。用户绑卡信息。card_id:用户绑定的银行卡号(可加密),people_id:身份证号(可加密),time:绑卡时间,ip:绑卡ip,imei:绑卡设备imei,deviceid:绑卡设备id,imei/deviceid必须至少提供一个,lat,lng:绑卡经纬度信息,status:绑卡结果(1成功,0失败),channel:绑卡渠道,baidu(百度钱包),alipay(支付宝),wechat(微信),qq,debitcard(借记卡),creditcard(信用卡),source:绑卡端,web,webapp,app等,wifi_mac:绑卡网络的wifi mac地址
card_id
string 
必需
people_id
string 
必需
ip
string 
必需
wifi_mac
string 
必需
imei
string 
必需
deviceid
string 
必需
status
string 
必需
channel
string 
必需
source
string 
必需
time
string 
必需
lng
number 
必需
lat
number 
必需
login_info
object 
必需
[ time, ip, lat, lng, wifi_mac, imei, deviceid, source, passid ]。最近一次登陆信息,time:登陆时间,ip:登陆ip,imei:登陆设备imei,deviceid:登录设备id,imei/deviceid必须至少提供一个,source:登录端,web,webapp,app等,lat,lng:登陆坐标位置信息,wifi_mac:登陆网络的wifi mac地址,passid:登录passid
ip
string 
必需
imei
string 
必需
deviceid
string 
必需
wifi_mac
string 
必需
time
string 
必需
lng
number 
必需
lat
number 
必需
remark
string 
可选
第三方传入的标记字段,长度限制为64位(过长则截取),在查询或者回调行程信息时返回,不做任何修改
o_type
integer 
必需
订单类别。 3 - 航班接机, 4 - 航班送机, 5 - 列车接站, 6 - 列车送站。 注:如果不能提供航班号/列车号和出发时间,本字段请勿赋值
traffic_no
string 
航班号/列车号
必需
traffic_date
string 
必需
航班/列车出发日期,Y-m-d:2016-08-30
date_type
integer 
可选
支持按航班/列车的到达时间提交数据。0:traffic_date为出发时间,1:traffic_date为到达时间
taxi_info
object 
可选
{"add_price":1000},出租车发单额外信息
add_price
integer 
可选
出租车调度费,单位为分,只支持100的倍数,最大为5000
price
object 
可选

{"amount":10000,"saving":2000,"coupon":2000},乘客支付的费用详情,计量单位必须是分。包括:总价、减免金额,券优惠金额,总价必须>=0,优惠减免金额必须<=总价。注:本字段仅对开放优惠权限的接入方有效

amount
string 
总价
必需
coupon
string 
可选
券优惠金额(滴滴优惠券)
saving
string 
减免金额
可选
pay_type
integer 
可选
支付类型:0线上支付(默认)1现金付 2预支付
new_version
integer 
可选
版本号标记,1新版本会做安全相关验证,0老版本不做验证(默认)
示例

返回响应

🟢200成功
application/json
Body
oid
string 
第三方订单id
必需
didi_oid
string 
滴滴订单id
必需
status
string 
行程状态(见备注)
必需
product_type
string 
产品类型
必需
ride_type
string 
运力类型
必需

【滴滴】API开发者 微信交流群

用微信扫右侧二维码,加入【滴滴】API开发者 交流群,互助沟通

扫码加入交流群
上一页
发单预校验接口
下一页
等待司机响应
Built with