文档中心 > API类目 > 商旅API

qimen.alitrip.btripcar.taxi.order.create (商旅用车-创建用车订单)

用户根据需要发起叫车请求，在发起请求之前必须事先获得order id.

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
uid	String	可选	123		用户唯一标识
order_id	String	必须	100000		请求id 获取请参见
type	Number	必须	0		叫车车型，0(实时)；1(预约)
passenger_phone	String	可选	15166666666		乘客手机号
city	String	必须	12		出发地城市
flat	String	必须	30.279212		出发地纬度
flng	String	必须	120.026208		出发地经度
start_name	String	必须	阿里巴巴西溪园区		出发地名称(最多50个字)
start_address	String	可选	浙江省杭州市余杭区文一西路969号		出发地详细地址(最多100个字)
tlat	String	可选	30.288773		目的地纬度
tlng	String	可选	120.068437		目的地经度
end_name	String	可选	蒋村花园		目的地名称(最多50个字)
end_address	String	可选	浙江省杭州市余杭区文一西路xxx号		目的地详细地址(最多100个字)
clat	String	可选	30.279212		当前位置纬度
clng	String	可选	120.026208		当前位置经度
departure_time	String	可选	2015-06-16 12:00:09		出发时间，不传表示现在用车（例如：2015-06-16 12:00:09
require_level	String	必须	600		车型代码
app_time	String	必须	2015-06-16 12:00:09		客户端时间（例如：2015-06-16 12:00:09
map_type	String	可选	amap		地图类型:amap：高德，默认高德地图
sms_policy	Number	可选	1		发送短信策略(0,为叫车人和乘车人都发送，1，乘车人发送叫车人不发，2乘车人不发叫车人发，3乘车人和叫车人都不发)
extra_info	String	可选	备注		备注
dynamic_md5	String	必须	ASDF324567GH6543ERGFD323434RF		价格md5,通过预估价接口获得
cost_center	String	可选	A2324234		成本中心代码，用于区分不同的分账账号
line_type	Number	可选	1		线路类型，0或空表示普通线路；1，表示一口价路线
carpool_type	Number	可选	1		0：不拼车 1:允许拼车，默认不拼车
passenger_number	Number	可选	2		乘车人数，允许拼车时该参数不为空
tail_number	String	可选	1918		乘客手机尾号，用于司乘尾号验证
accept_relay_order	Number	可选	1		是否允许派接力单（0:不允许 1:允许），默认允许
start_poi_id	String	可选	150200		出发地高德POI唯一标识
end_poi_id	String	可选	150300		目的地高德POI唯一标识
waypoints	String	可选	[ { "index" : 1, "longitude": "116.407396", "latitude": "39.904200", "address": "天安门广场", "status": 0, }, { "index" : 2, "longitude": "121.473701", "latitude": "31.230416", "address": "东方明珠", "status": 0 } ]		途径点列表，带途径点下单时存在本字段，且内容不为空
price_type	Number	可选	0	默认值：0	价格类型 0:商旅价 1:商旅协议价默认0

响应参数

名称	类型	示例值	描述
errno	Number	0	错误码
data	OrderCreateResult		订单创建结果
order OrderInfo 订单信息 └ id String 4880109188406595918 订单id └ city String 1 城市id └ type Number 0 订单类型 └ call_phone String 13269661202 叫车人手机号 └ passenger_phone String 13269661202 乘车人手机号 └ status Number 300 订单状态 └ flat String 40.045724 出发地纬度 └ flng String 116.307479 出发地经度 └ tlat String 39.689123 目的地纬度 └ tlng String 116.800012 目的地经度 └ clat String 39.689123 当前纬度 └ clng String 116.800012 当前经度 └ start_name String 得实大厦出发地名称 └ start_address String 上地东路9号西南角出发地地址 └ end_name String 万达广场目的地名称 └ end_address String 北京市石景山区万达广场目的地地址 └ extra_info String 这是订单备注备注 └ departure_time String 2015-03-11 17:06:58 出发时间 └ order_time String 2015-03-11 17:06:58 下单时间 └ require_level String 100 所需车型代码 └ remark String 备注备注 └ cost_center String A2324234 成本中心代码，用于区分不同的分账账号 price PriceInfo 价格信息 └ estimate String 20.12 预估车费
errmsg	String	SUCCESS	错误信息
code	String	SUCCESS	二级错误码

请求示例

响应示例

{
    "errno":0,
    "data":{
        "order":{
            "id":"4880109188406595918",
            "city":"1",
            "type":0,
            "call_phone":"13269661202",
            "passenger_phone":"13269661202",
            "status":300,
            "flat":"40.045724",
            "flng":"116.307479",
            "tlat":"39.689123",
            "tlng":"116.800012",
            "clat":"39.689123",
            "clng":"116.800012",
            "start_name":"得实大厦",
            "start_address":"上地东路9号西南角",
            "end_name":"万达广场",
            "end_address":"北京市石景山区万达广场",
            "extra_info":"这是订单备注",
            "departure_time":"2015-03-11 17:06:58",
            "order_time":"2015-03-11 17:06:58",
            "require_level":"100",
            "remark":"备注",
            "cost_center":"A2324234"
        },
        "price":{
            "estimate":"20.12"
        }
    },
    "errmsg":"SUCCESS",
    "code":"SUCCESS"
}

验签示例

{"errno":"不等于0","code":"sign-check-failure","errmsg":"Illegal request"}

错误码解释

错误码	错误描述	解决方案
response-body-parse-error

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

商旅API

qimen.alitrip.btripcar.taxi.order.create (商旅用车-创建用车订单)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ