滴滴 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/
PUT
/v1/orders/{didi_oid}/cancel
功能: 取消行程
支持运力: 所有运力类型
注:取消可能需要支付取消费用。若用户频繁取消(24小时内超过3次),将被封禁24小时(提供用户id,则封禁id,未提供,则封禁手机号)
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.xiaojukeji.com//v1/orders//cancel' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{"cancel_msg":"Driver Late","device":{"imei":"YUIANE987","suuid":"132456987","time":"2016-03-01T10:00:00+0800"},"lat":"37.7766874","lng":"122.394857"}'
响应示例响应示例
200 - 示例 1
{
    "status": "string",
    "oid": "string",
    "didi_oid": "string",
    "cancel_token": "string",
    "cancel_fee": "string"
}

请求参数

Path 参数
didi_oid
string 
行程ID
必需
Header 参数
Content-Type
string 
必需
示例值:
application/json
Authorization
string 
必需
默认值:
Bearer domain|{{access_token}}
Body 参数application/json
cancel_msg
string 
取消原因
可选
device
object 
必需
设备相关信息,用于安全风控处理。如:{"imei":"12wdw","suuid":"123juuiuiausd","network":"WIFI","wifi_name":"tp_link123","wifi_ip":"10.10.10.10","wifi_mac":"asdasasd"}
imei
string 
必需
imei/suuid必须存在一个
suuid
string 
必需
imei/suuid必须存在一个
time
string 
必需
ip
string 
设备ip地址
必需
network
string 
可选
如果network为wifi,wifi_name,wifi_ip,wifi_mac必须提供
wifi_name
string 
wifi名称
可选
wifi_ip
string 
wifi ip地址
可选
wifi_mac
string 
可选
wifi mac地址
lat
number 
用户当前坐标
必需
lng
number 
用户当前坐标
必需
passenger_phone
string 
必需
乘车人手机号码,避免错误取消
map_type
string 
可选
坐标系类型,默认soso,支持坐标系见备注
cancel_token
string 
必需
接入二次取消的必传参数,token有效时长20秒
type
integer 
必需
1:二次取消第一次取消请求;2:二次取消第二次取消确认;0:默认值,旧取消方式;0和1+2两种方式不能同时存在
示例

返回响应

🟢200成功
application/json
Body
status
string 
必需
oid
string 
必需
didi_oid
string 
必需
cancel_token
string 
必需
cancel_fee
string 
必需
🟠400失败

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

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

扫码加入交流群
上一页
发单后修改行程
下一页
司机位置
Built with