曹操出行开放平台

下单叫车

发起叫车请求，预约单叫车最多只能预约3天，且预约时间必须比当前时间大半个小时以上。该接口对ext_order_id幂等，只要创建订单成功就算成功，司机接单会回调接入方（回调状态见《1.5 订单状态及类型》）。派单等待时长120s，如120s后附近无司机接单，则订单会被系统撤销，需要改变ext_order_id重新下单

请求地址： /v2/common/orderCar

服务协议： HTTP/POST

Content-Type： application/x-www-form-urlencoded

请求参数：

参数名称 类型 必选 说明
client_id string Y 申请时的client_id
timestamp long Y 时间戳
sign string Y 签名
cost_center string N 以集团公司类型接入必填，企业标识与企业名称关联关系告知曹操技术人员
from_longitude string Y 出发地经度
from_latitude string Y 出发地纬度
to_longitude string Y 目的地经度 （订单类型为日租、半日租时，目的地经纬度参数非必传）
to_latitude string Y 目的地纬度
car_type string Y 服务车型：2 新能源；3 舒适型；4 豪华型；5 商务型；7 优选; 14 智能大白车;15 礼帽专车（不支持一次性下多个订单）
ext_order_id string Y 外部接入方的订单ID，最长30个字符（外部订单ID唯一，禁止重复）
passenger_phone string N 乘车人手机号，不填表示给自己叫车
passenger_hide_phone string N 乘车人脱敏手机号，依赖手机号后四位用于司机端展示，便于司乘确认身份（传入乘客虚拟号的接入方该字段必传）
passenger_name string N 乘车人姓名
caller_phone string Y 用户手机号
ext_uid string N 第三方用户ID
estimate_price string Y 预估费用，单位为分，允许拼车订单需要传入未拼成一口价
estimate_price_key string Y 预估费用接口返回的price_key，订单若 price_key 过期（有效期：10分钟）则无法下单，需要重新预估价格获取
city_code string Y 城市编码（与起点对应的citycode保持一致）
order_type string Y 订单类型，请参照《1.5 订单状态及类型》
dynamic_rule_id string N 动态折扣ID，预估费用接口返回的dynamicRuleId(动态折扣订单必传)
flight_no string N 航班号,接机单必传
flt_takeoff_time string N 航班起飞时间,接机单需要传递(格式:yyyy-MM-dd HH:mm:ss)
departure_time string N 用车时间, 预约单必填(格式:yyyy-MM-dd HH:mm:ss)，预约单用车时间必须大于等于当前时间30分钟，不超过当前时间往后72小时
start_name string Y 出发点名称(最多16个字)
start_address string Y 出发点详细地址，展示在司机端（最多100个字）
end_name string Y 目的地名称(最多16个字)
end_address string Y 目的地详细地址，展示在司机端（做多100个字）
order_longitude string N 下单地经度
order_latitude string N 下单地纬度
sms_policy string N 短信发送--1：叫车人和乘车人都发送;2：乘车人发送叫车人不发送;3：乘车人不发叫车人发;4：乘车人叫车人都不发
不传默认不发
extra_info string N 下单时给司机展示的备注信息
callback_info string N 状态通知原样透传(回调通知支持回调该参数；最大100字,不允许有’;;’, ‘'’)
order_tags string N 1.支付方式选择一口价，值为 1 （一口价需与商务确认开通权限）；2.支付方式选择（前置）现金支付，值为4（选择现金支付须告知曹操专车开发人员）；3.正常计费不用传参或传0
line_type string N 值为1，路线一口价必传（路线一口价：订单起终点符合条件时，价格固定，若要了解可咨询商务）
accept_cp_driver string N 是否允许被加盟运力接单（0不使用加盟、 1使用加盟），默认为使用加盟运力
accept_relay_order string N 是否允许派接力单（0不允许、 1允许派接力单），默认为允许派接力单
start_poi_id string N 开始点POI (高德地图)
end_poi_id string N 结束点POI (高德地图)
carpool_type int N 是否允许拼车：0 不拼车；1 允许拼车，默认为不拼车
count_person int N 拼车乘车人数，允许拼车时必填，必须为1或2

响应data参数：

参数名称 类型 必有 说明
orderNo string Y 订单号

结果示例：

{
  "code": 200,
  "success": true,
  "data": {
  "orderNo": "123456"
  }
}

多车型下单叫车

发起叫车请求，预约单叫车最多只能预约3天，且预约时间必须比当前时间大半个小时以上。该接口对ext_order_id幂等，只要创建订单成功就算成功，司机接单会回调接入方（回调状态见《1.5 订单状态及类型》）。派单等待时长120s，如120s后附近无司机接单，则订单会被系统撤销，需要改变ext_order_id重新下单。 多车型呼叫也支持单车型呼叫。

请求地址： /v2/common/orderCarV2

服务协议： HTTP/POST

Content-Type： application/x-www-form-urlencoded

请求参数：

参数名称 类型 必选 说明
client_id string Y 申请时的client_id
timestamp long Y 时间戳
sign string Y 签名
cost_center string N 以集团公司类型接入必填，企业标识与企业名称关联关系告知曹操技术人员
from_longitude string Y 出发地经度
from_latitude string Y 出发地纬度
to_longitude string Y 目的地经度 （订单类型为日租、半日租时，目的地经纬度参数非必传）
to_latitude string Y 目的地纬度
car_type string N 服务车型：2 新能源；3 舒适型；4 豪华型；5 商务型；7 优选；12 超惠 ;14 智能大白车；15 礼帽专车。多车型同时呼叫可以不传，单车型必传
ext_order_id string Y 外部接入方的订单ID，最长30个字符（外部订单ID唯一，禁止重复）
passenger_phone string N 乘车人手机号，不填表示给自己叫车
passenger_hide_phone string N 乘车人脱敏手机号，依赖手机号后四位用于司机端展示，便于司乘确认身份（传入乘客虚拟号的接入方该字段必传）
passenger_name string N 乘车人姓名
caller_phone string Y 用户手机号
ext_uid string N 第三方用户ID
estimate_price string N 预估费用，单位为分，允许拼车订单需要传入未拼成一口价。多车型同时呼叫可以不传，单车型必传
estimate_price_key string N 预估费用接口返回的price_key，订单若 price_key 过期（有效期：10分钟）则无法下单，需要重新预估价格获取。多车型同时呼叫可以不传，单车型必传
city_code string Y 城市编码（与起点对应的citycode保持一致）
order_type string Y 订单类型，请参照《1.5 订单状态及类型》
dynamic_rule_id string N 动态折扣ID，预估费用接口返回的dynamicRuleId(动态折扣订单必传)
flight_no string N 航班号,接机单必传
flt_takeoff_time string N 航班起飞时间,接机单需要传递(格式:yyyy-MM-dd HH:mm:ss)
departure_time string N 用车时间, 预约单必填(格式:yyyy-MM-dd HH:mm:ss)，预约单用车时间必须大于等于当前时间30分钟，不超过当前时间往后72小时
start_name string Y 出发点名称(最多16个字)
start_address string Y 出发点详细地址，展示在司机端（最多100个字）
end_name string Y 目的地名称(最多16个字)
end_address string Y 目的地详细地址，展示在司机端（做多100个字）
order_longitude string N 下单地经度
order_latitude string N 下单地纬度
sms_policy string N 短信发送--1：叫车人和乘车人都发送;2：乘车人发送叫车人不发送;3：乘车人不发叫车人发;4：乘车人叫车人都不发
extra_info string N 下单时给司机展示的备注信息
callback_info string N 状态通知原样透传(回调通知支持回调该参数；最大100字,不允许有’;;’, ‘'’)
order_tags string N 1.支付方式选择一口价，值为 1 （一口价需与商务确认开通权限）；2.支付方式选择（前置）现金支付，值为4（选择现金支付须告知曹操专车开发人员）；3.正常计费不用传参或传0
line_type string N 实时计费不传；一口价场景必传、值为1
accept_cp_driver string N 是否允许被加盟运力接单（0不使用加盟、 1使用加盟），默认为使用加盟运力
accept_relay_order string N 是否允许派接力单（0不允许、 1允许派接力单），默认为允许派接力单
如始终不接受接力单、可联系客户经理关闭【即将上线】
start_poi_id string N 开始点POI (高德地图)
end_poi_id string N 结束点POI (高德地图)
carpool_type int N 是否允许拼车：0 不拼车；1 允许拼车，默认为不拼车
count_person int N 拼车乘车人数，允许拼车时必填，必须为1或2
is_simultaneously_call String Y “1”代表多车型同时呼叫的订单，传“0”代表单车型呼叫订单（必传）
service_type_price String N 多车型同时呼叫车型、预估价格和预估key的对应信息，传入一个Json格式的list。（多车型同时呼叫的订单必传）

service_type_price里的格式，预估车型、预估key和预估价格都要按照预估接口返回的一一对应正确传入，若有其中任意一个传入对应不上或不存在，就会报错返回

参数名称 类型 必选 说明
serviceType Integer Y 车型
estimateKey String Y 预估Key
estimatePrice Integer Y 预估价格（单位：分）
fixLineType Integer N 一口价必传，传1

service_type_price例子：

[
{
    "serviceType":2, 
    "estimateKey":"sdfjk234-234hj-dwfwef", 
    "estimatePrice":3920,
    "fixLineType":1
},
{
    "serviceType":3,
    "estimateKey":"sdfjk234-234hj-dwfwef",
    "estimatePrice":4920,
    "fixLineType":1
}
]

响应data参数：

参数名称 类型 必有 说明
orderNo string Y 订单号

结果示例：

{
  "code": 200,
  "success": true,
  "data": {
  "orderNo": "123456"
  }
}