接口说明
- 下单接口
接口地址
https:// <Partner_DOMAIN>/<CallBackURL>
请求方式
POST
请求参数
| 名称 |
类型 |
是否必选 |
说明 |
| sign |
string |
yes |
参加sign生成算法 |
| channel |
string |
yes |
渠道名称(标识首约调用) |
| partnerOrderNo |
string |
yes |
首约订单号 |
| bookingDate |
string |
yes |
预定日期时间，10位时间戳(秒数) |
| cityId |
string |
yes |
城市id |
| serviceType |
int |
yes |
服务类型 |
| groupIds |
string |
yes |
下单车型，如"34" |
| priceMark |
string |
yes |
预估返回的价格标识 |
| bookingStartAddr |
string |
yes |
上车地点(URLEncode编码后的值) |
| bookingStartPointLo |
string |
yes |
上车地点经度坐标 |
| bookingStartPointLa |
string |
yes |
上车地点纬度坐标 |
| bookingEndAddr |
string |
yes |
下车地点(URLEncode编码后的值) |
| 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-是,其他-否 |
| extData |
String |
no |
JSON格式字符串。如{"buyoutFlag":1}。具体说明见下方 |
| passingPoints |
String |
no |
途经点列表(JSON字符串):目前只支持两个途经点,约定按照顺序先后确定第一个途经点与第二个途经点 |
passingPoints请求参数
| 名称 |
类型 |
是否必选 |
说明 |
| bookingPassingLng |
String |
yes |
途经点经度如:"118.59252" |
| bookingPassingLat |
String |
yes |
途经点纬度如:"24.800137" |
| bookingPassingPointAddr |
String |
yes |
途经点地址如:"晋江机场航站楼" |
| bookingPassingPointShortAddr |
String |
no |
途经点短地址:"航站楼" |
extData扩展项
| 名称 |
类型 |
是否必选 |
说明 |
| cooperationUserId |
String |
yes |
用户Id |
| buyoutFlag |
int |
no |
一口价标识，1为一口价 |
| supportModifyStart |
int |
no |
修改上车点标识位，1为支持 |
| supportModifyDestination |
int |
no |
修改下车点标识位，1为支持 |
| supportModifyPassingpoints |
int |
no |
修改/新增途经点标识位，1为支持 |
返回数据
| 名称 |
类型 |
说明 |
| result |
Integer |
0:成功；非0：失败原因编码 |
| errmsg |
string |
失败原因描述，若成功则值为空 |
| data |
object |
订单号 |
返回示例
{
"result": 0,
"errmsg": "SUCCESS",
"data": {
"orderNo": "B7518002632952624"
}
}