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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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唯一标识

响应参数

名称 类型 示例值 描述
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工具

FAQ

返回
顶部