曹操出行开放平台
- 用车API
- 充电桩API
- 优惠券API
- 两融API
接驳车预估(维护中)
请求地址： /v2/common/estimatePriceShuttleBus
服务协议： HTTP/POST
Content-Type： application/x-www-form-urlencoded
请求参数：
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| client_id | string | Y | 申请的client_id |
| timestamp | long | Y | 时间戳 |
| sign | string | Y | 签名 |
| city_code | string | Y | 城市编号 |
| order_type | string | Y | 订单类型，请参照《1.5 订单状态及类型》 |
| departure_time | string | N | 预约单时间 |
| car_type | string | Y | 服务车型：2 新能源；3 舒适型；4 豪华型；5 商务型；7 优选；12 超惠（不支持一次性下多个订单） |
| shuttle_bus_type | string | Y | 接驳车类型 1多接一送 2一接多送 |
| waypoint_param | string | Y | 途经点JSON字符串 |
waypoint_param参数对象：
| 参数名称 | 类型 | 必选 | 说明 |
|---|---|---|---|
| waypointType | Number | Y | 途经点类型：1.起点，2.终点 |
| waypointCityCode | string | Y | 途经点城市代码 |
| waypointDistrict | string | Y | 途经点位置区域 |
| waypointDistrictCode | string | Y | 途经点区域code |
| waypointLg | string | Y | 用户下单途经点经度 |
| waypointLt | Number | Y | 用户下单途经点纬度 |
| waypointLoc | String | Y | 用户下单途经点地址详情 |
| waypointLocName | string | Y | 用户下单途经点地址名称 |
| waypointSequence | Number | Y | 途经点顺序 默认从1开始 |
waypoint_param参数示例：
[
{
"waypointCityCode":"0571",
"waypointDistrict":"滨江区",
"waypointDistrictCode":"330108",
"waypointLg":120.2199,
"waypointLoc":"物联网孵化器",
"waypointLocName":"物联网孵化器",
"waypointLt":30.213688,
"waypointSequence":1,
"waypointType":1
},
{
"waypointCityCode":"0571",
"waypointDistrict":"滨江区",
"waypointDistrictCode":"330108",
"waypointLg":120.212396,
"waypointLoc":"东方郡西区",
"waypointLocName":"东方郡西区",
"waypointLt":30.197035,
"waypointSequence":2,
"waypointType":1
},
{
"waypointCityCode":"0571",
"waypointDistrict":"滨江区",
"waypointDistrictCode":"330108",
"waypointLg":120.166877,
"waypointLoc":"滨江宝龙城",
"waypointLocName":"滨江宝龙城",
"waypointLt":30.18733,
"waypointSequence":3,
"waypointType":2
}
]
响应data参数：
| 参数名 | 类型 | 必有 | 说明 |
|---|---|---|---|
| carType | int | Y | 服务车型code |
| name | string | Y | 车型名称 |
| price | int | Y | 预估价格，单位分，允许拼车时为拼成一口价 |
| originPrice | int | Y | 预估价格打折前原价，单位分，允许拼车时为未拼成一口价 |
| distance | int | Y | 预估行程距离，单位米 |
| duration | int | Y | 预估行程时间，单位秒 |
| priceKey | string | Y | 预估金额的key，订单会对预估金额做校验，priceKey有效期为10分钟，如果priceKey过期或出发地经纬度有变化必须重新预估 |
| derateType | int | N | 折扣类型 1：企业折扣，2：动态折扣 |
| dynamicRuleId | int | N | 动态折扣ID（企业具备此权限，derateType值为2时才有值），下单时值原样传入 |
| lineType | int | Y | 订单专线类型:0 - 普通类型,1 - 一口价类型 |
| detail.amount | int | Y | 价格，单位分 |
| detail.chargeCode | string | Y | 价格类型code,，start_fee：订单起步价；travel_km_fee：里程费用；travel_minute_fee：时长费用；long_km_fee：长途费；long_km2_fee：超远长途费；night_fix, 夜间起步费用;night_fee：夜间行驶超长费用；lowest_cost_fee：基础费用补充额（预约单基础费30元，例如一笔预约单初始预估18元，则基础费用补充额为12元）；discount_fee：折扣金额；park_fee：停车费用；bridge_fee：路桥费；other_fee：其他费用；refund_fee：退款金额（客服改价/免单产生的退款金额）；hight_speed_fee：高速费；festival_fee:节日服务费 |
| detail.chargeDesc | string | Y | 价格描述（基础费用补充额：曹操预约单基础费为30元，若预约单预估价超过30元则基础费用补充额为0元） |
| billAreaInfoVO.areaCode | string | N | 区域编码 |
| billAreaInfoVO.areaName | string | N | 区域名称 |
| billAreaInfoVO.areaType | int | N | 区域类型,0-城市,1-行政区,2-围栏 |
结果示例：
{
"code": 200,
"success": true,
"data": [
{
"billAreaInfoVO": {
"areaCode": "330108",
"areaName": "滨江区",
"areaType": 1
},
"carType": 2,
"detail": [
{
"amount": 1000,
"chargeCode": "start_fee",
"chargeDesc": "订单起步价"
},
{
"amount": 800,
"chargeCode": "travel_km_fee",
"chargeDesc": "里程费用"
},
{
"amount": 450,
"chargeCode": "travel_minute_fee",
"chargeDesc": "时间费用"
},
{
"amount": 0,
"chargeCode": "discount_fee",
"chargeDesc": "折扣金额"
},
{
"amount": 0,
"chargeCode": "night_fix",
"chargeDesc": "夜间费用"
},
{
"amount": 0,
"chargeCode": "long_km_fee",
"chargeDesc": "订单长途费用"
},
{
"amount": 0,
"chargeCode":"lowest_cost_fee",
"chargeDesc": "最低消费补充差额"
}
],
"distance": 12759,
"duration": 1200,
"lineType": 0,
"name": "新能源",
"price": 2250,
"priceKey": "64f6681a-7a77-4ebd-8e36-e7175612559f"
},
{
"billAreaInfoVO": {
"areaCode": "330108",
"areaName": "滨江区",
"areaType": 1
},
"carType": 3,
"detail": [
{
"amount": 1400,
"chargeCode": "start_fee",
"chargeDesc": "订单起步价"
},
{
"amount": 56,
"chargeCode": "travel_km_fee",
"chargeDesc": "路长费用"
},
{
"amount": 0,
"chargeCode": "discount_fee",
"chargeDesc": "折扣金额"
},
{
"amount": 0,
"chargeCode": "night_fix",
"chargeDesc": "夜间费用"
},
{
"amount": 0,
"chargeCode": "long_km_fee",
"chargeDesc": "订单长途费用"
}
],
"distance": 12759,
"duration": 1200,
"lineType": 0,
"name": "舒适型",
"originPrice":1460,
"price": 1456,
"priceKey": "6e56bdb4-3bb0-4482-b3fb-bc2fc78fa428"
}
]
}