请求行程

功能：根据起点、终点、运力类型，创建行程

支持运力：所有，各车型接入均需申请

注：默认为soso坐标系，坐标必须精确到小数点后6位，可以使用接口文档中的poi功能接口

拦截相关错误码：

录音授权拦截

{
    "error":"code(62003)",
    "error_detail":"请进行录音授权"
}

录音录像授权拦截

{
    "error":"code(62004)",
    "error_detail":"请进行录音、录像授权"
}

封禁拦截

{
    "error":"code(62005)",
    "error_detail":"封禁拦截"
}

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}}}'

请求参数

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）

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

必需

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

必需

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

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老版本不做验证(默认)

示例

application/json

Body

oid

string

第三方订单id

必需

didi_oid

string

滴滴订单id

必需

status

string

行程状态（见备注）

必需

product_type

string

产品类型

必需

ride_type

string

运力类型

必需

请求参数

返回响应