淘宝开放平台 - 文档中心

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
order_id	String	必须	12333234		订单id

名称	类型	示例值	描述
errno	Number	0	错误码
data	OrderGetResult		订单获取结果
price CostInfo 费用信息，如果订单有折扣，这里为折后价格，如果没有折扣，这里和original_price保持一致 └ original_price String 213.00 原价，如果订单有折扣这里为折扣前的价格，如果没有折扣和total_price字段保持一致 └ total_price String 23.00 总费用，折后金额 detail CostDetailInfo [] 费用明细 └ type String empty_fee 费用类型，如果不需要显示直接设为null，为0也会显示出来。discount_fee:折扣金额;refund_price：退款;empty_fee：远途费或超出套餐部分远途费; highway_fee：高速费; bridge_fee：路桥费; low_speed_fee：低速费或超出套餐低速费; night_fee：夜间费用或超出套餐部分夜间费; normal_fee：正常行驶费用或超出套餐部分行驶距离费; other_fee：其他费用; park_fee：停车费; start_price：起步价格; tip_fee：加价费用; limit_fee：车最低消费; combo_fee：套餐费用; normal_time_fee：快车时长费; cancel_fee：违约费; dynamic_price：动态调价费用; wait_fee：等候费; clear_fee：清洁费; cross_city_fee：跨城费; protocol_discount_fee：协议折扣金额 └ name String 远途费或超出套餐部分远途费费用类型名称 └ amount String 12.00 费用金额单位：元 carpool CarpoolInfo 拼车信息 └ carpool_flag Number 1 0: 未拼成 1:拼成 passenger_orders PassengerOrderInfo [] 乘客订单信息 └ tlng String 120.068437 目的地经度 └ flat String 30.279212 出发地纬度 └ passenger_number String 2 乘客人数 └ sub_status String 6101 订单详细状态码 └ id String 488010918840 订单id └ tlat String 30.288773 目的地纬度 └ status String 610 订单状态码 └ flng String 120.026208 出发地经度 └ carpool_order_id String 6892382 拼车单id reassign_info ReassignInfo 订单改派信息 └ init_order_id String 1125905027640526 第一个被改派的订单id └ pre_order_id String 1125905027640526 改派前订单id，即此订单由哪个订单id改派而生成（当值为空时，表示该订单不是因为改派而生成的） └ next_order_id String 1125905027643751 改派后订单id，即由于订单改派而产生的订单id（当值为空时，表示当前订单未被改派而产生新订单） └ latest_order_id String 1125905027643751 最新被指派的订单id order OrderInfo 订单信息 └ driver_id String 1 司机唯一标识 └ city String 1 城市id └ tlng String 116.800012 目的地经度 └ strive_time String 2016-05-26 12:37:02 司机接单时间 └ driver_avatar String http://xxxxx.jpg 司机头像 └ normal_time Number 60 实际行驶时长（分钟） └ remark String 无法联系到乘客备注，如取消原因 └ driver_car_type String 日产天籁司机车型 └ order_time String 2015-03-11 17:06:58 下单时间 └ type Number 0 订单类型(0:实时、1:预约) └ clng String 116.307479 乘客发单时位置经度 └ flng String 116.307479 出发经度 └ begin_charge_time String 2015-03-11 15:06:58 开始计价时间 └ dlat String 40.045724 司机当前实时纬度 └ flat String 40.045724 出发纬度 └ id String 4880109188406595918 订单id └ tlat String 39.689123 目的地纬度 └ departure_time String 2015-03-11 17:06:58 出发时间 └ passenger_phone String 13269661202 乘车人手机号 └ driver_num Number 109 已通知司机数量 └ strive_level String 100 实际车型代码 └ driver_order_count Number 307 司机抢单数 └ reach_time String 2015-03-11 16:06:58 司机到达时间 └ delay_time_start String 2015-03-11 15:06:58 迟到计费时间 └ sub_status Number 4001 订单详细状态码 └ normal_distance String 4.80 实际行驶公里数 └ driver_card String 冀A**G05 司机车牌 └ driver_phone String 18612249028 号码保护中间号（如无号码保护，为司机真实手机号） └ driver_level String 4.9 司机星级 └ dlng String 116.307479 司机当前实时经度 └ finish_time String 2015-03-11 16:06:58 行程结束时间 └ driver_car_color String 白汽车的颜色 └ driver_name String 张师傅司机称呼 └ start_name String 得实大厦出发地名称 └ clat String 40.045724 乘客发单时位置维度 └ extra_info String 微信支付扩展信息 └ start_address String 得实大厦东门出发地详细地址 └ require_level String 100 车型代码。批量下单需要返回最终接单司机对应的车型码信息 └ end_name String 万达广场目的地名称 └ driver_phone_real String 18612249028 司机真实手机号 └ end_address String 万达广场西北角目的地详细地址 └ status Number 400 订单状态码 └ relay_order Number 1 接力单（0:否 1:是）默认否 waypoints Waypoint [] 否途径点列表，带途径点下单时存在本字段，且内容不为空 └ status Number 1 途径点状态：0 未经过(默认) 1（已经过） └ address String 天安门途经点地址 └ longitude String 30.288773 途经点位置纬度 └ latitude String 30.288773 途经点位置经度 └ index Number 1 途经点顺序下标 └ price_type Number 0 价格类型 0:商旅价 1:商旅协议价 └ is_allowed_modify_destination Number 1 是否可以修改终点 0:不可以修改 1:可以修改 └ not_allow_modify_destination_reason String 不允许修改目的地原因预约单不支持修改 relay_order RelayOrderInfo 司机上一单信息(接力单) └ status Number 1 订单状态（0:服务中 1:已完成）默认已完成 └ end_location_lat String 30.288773 目的地纬度 └ end_location_lng String 30.288773 目的地经度
errmsg	String	SUCCESS	错误信息
code	String	SUCCESS	二级错误码

{"order_id":"12333234"}

{
    "errno":0,
    "data":{
        "price":{
            "original_price":"213.00",
            "total_price":"23.00",
            "detail":[
                {
                        "type":"empty_fee",
                        "name":"远途费或超出套餐部分远途费",
                        "amount":"12.00"
                }
            ]
        },
        "carpool":{
            "carpool_flag":1,
            "passenger_orders":[
                {
                        "tlng":"120.068437",
                        "flat":"30.279212",
                        "passenger_number":"2",
                        "sub_status":"6101",
                        "id":"488010918840",
                        "tlat":"30.288773",
                        "status":"610",
                        "flng":"120.026208"
                }
            ],
            "carpool_order_id":"6892382"
        },
        "reassign_info":{
            "init_order_id":"1125905027640526",
            "pre_order_id":"1125905027640526",
            "next_order_id":"1125905027643751",
            "latest_order_id":"1125905027643751"
        },
        "order":{
            "driver_id":"1",
            "city":"1",
            "tlng":"116.800012",
            "strive_time":"2016-05-26 12:37:02",
            "driver_avatar":"http:\/\/xxxxx.jpg",
            "normal_time":60,
            "remark":"无法联系到乘客",
            "driver_car_type":"日产天籁",
            "order_time":"2015-03-11 17:06:58",
            "type":0,
            "clng":"116.307479",
            "flng":"116.307479",
            "begin_charge_time":"2015-03-11 15:06:58",
            "dlat":"40.045724",
            "flat":"40.045724",
            "id":"4880109188406595918",
            "tlat":"39.689123",
            "departure_time":"2015-03-11 17:06:58",
            "passenger_phone":"13269661202",
            "driver_num":109,
            "strive_level":"100",
            "driver_order_count":307,
            "reach_time":"2015-03-11 16:06:58",
            "delay_time_start":"2015-03-11 15:06:58",
            "sub_status":4001,
            "normal_distance":"4.80",
            "driver_card":"冀A**G05",
            "driver_phone":"18612249028",
            "driver_level":"4.9",
            "dlng":"116.307479",
            "finish_time":"2015-03-11 16:06:58",
            "driver_car_color":"白",
            "driver_name":"张师傅",
            "start_name":"得实大厦",
            "clat":"40.045724",
            "extra_info":"微信支付",
            "start_address":"得实大厦东门",
            "require_level":"100",
            "end_name":"万达广场",
            "driver_phone_real":"18612249028",
            "end_address":"万达广场西北角",
            "status":400,
            "relay_order":1,
            "waypoints":[
                {
                        "status":1,
                        "address":"天安门",
                        "longitude":"30.288773",
                        "latitude":"30.288773",
                        "index":1
                }
            ],
            "price_type":0,
            "is_allowed_modify_destination":1,
            "not_allow_modify_destination_reason":"不允许修改目的地原因"
        },
        "relay_order":{
            "status":1,
            "end_location_lat":"30.288773",
            "end_location_lng":"30.288773"
        }
    },
    "errmsg":"SUCCESS",
    "code":"SUCCESS"
}

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

错误码	错误描述	解决方案
response-body-parse-error
isp.http-connection-timeout
isp.http-read-timeout

错误码查询工具 SDK下载

开放平台

商旅API

qimen.alitrip.btripcar.taxi.order.get (商旅用车-获取订单详情)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ