接口说明
- 该接口可以完成送机下单
接口地址
https:// <Partner_DOMAIN>/<CallBackURL>
请求方式
POST
请求参数
名称 |
类型 |
是否必选 |
说明 |
channel |
string |
yes |
渠道名称(标识首约调用) |
serviceType |
string |
yes |
服务类型(送机:5) |
partnerOrderNo |
string |
yes |
首约订单号 |
bookingDate |
string |
yes |
预定日期时间,10位时间戳(秒数) |
cityId |
string |
yes |
城市ID |
groupIds |
string |
yes |
下单车型,如34 |
priceMark |
string |
no |
预估返回的价格标识 |
bookingStartAddr |
string |
yes |
上车地点 |
bookingStartPointLo |
string |
yes |
上车地点经度坐标 |
bookingStartPointLa |
string |
yes |
上车地点纬度坐标 |
bookingEndAddr |
string |
yes |
下车地点 |
bookingEndPointLo |
string |
yes |
下车地点经度坐标 |
bookingEndPointLa |
string |
yes |
下车地点纬度坐标 |
riderName |
string |
no |
乘车人姓名,URLEncode编码后的 |
riderPhone |
string |
no |
乘车人手机号 (此手机号可能为空或不准确,请一定以确认使用司机时传递的乘客虚拟号为准,创建司乘绑定关系) |
bookingUserId |
int |
no |
预订人用户id(乘车人手机号为空时,此字段必填) |
phoneLastFour |
String |
no |
乘客真实手机号后4位 |
cancelFeeFlag |
int |
yes |
是否收取取消费:1-是,其他-否 |
maxEstimateAmount |
String |
no |
派单最大预估金额,选填,聚合运力使用 |
extData |
String |
no |
JSON格式字符串。如{"buyoutFlag":1}。具体说明见下方 |
sign |
string |
yes |
参见sign生成算法 |
extData扩展项
名称 |
类型 |
是否必选 |
说明 |
buyoutFlag |
int |
no |
一口价标识,1为一口价 |
supportModifyStart |
int |
no |
修改上车点标识位,1为支持 |
supportModifyDestination |
int |
no |
修改下车点标识位,1为支持 |
supportModifyPassingpoints |
int |
no |
修改/新增途经点标识位,1为支持 |
返回数据
名称 |
类型 |
说明 |
result |
string |
0:成功;非0:失败原因编码 |
errmsg |
string |
失败原因描述,若成功则值为空 |
data |
OrderResultDTO |
下单结果,参见OrderResultDTO |
返回示例
{
"result": 0,
"errmsg": "SUCCESS",
"data": {
"orderId": "198813025",
"orderNo": "B7518002632952624",
"returnCode": "0"
}
}