文档
测试

2.获取城市下可选车型信息

POST
https://openapi-pre.huolala.cn/api/e-city-info

服务入口

测试环境:https://openapi-pre.huolala.cn/api/e-city-info 正式环境:https://openapi.huolala.cn/api/e-city-info

公共请求参数

参数名
类型
描述
必填
app_key
string
开发者应用唯一标识.
必填
access_token
string
货拉拉用户授权给【开发者应用】的账户访问令牌码
必填
nonce_str
string
随机数,用户自定义,60s内不可重复使用,仅用于保证签名不可预测;示例:474
必填
timestamp
string
Unix时间戳(单位:秒),60s内有效,超过60s则超时;示例:1565225482
必填

前端UI参考

![image.png](https://cos.easydoc.net/48578360/files/k9xs8jvr)

应用级请求参数

参数名
类型
描述
必填
city_id
number
城市id号;示例:1002代表深圳
必填

响应参数

参数名
类型
描述
必填
ret
number
结果码,示例:0
必填
msg
string
结果描述,示例:Success
必填
data
object
数据字典
必填
city_id
int
城市id, 示例:1002
必填
name
string
城市名称(中文), 示例:深圳
必填
name_en
string
城市名称(英文), 示例:shenzhen
必填
revision
int
城市最新版本号
必填
vehicle_arr
array
城市可选车型列表
必填
order_vehicle_id
int
车型ID
必填
name
string
车型名称, 示例:小面包车
必填
img_url_high_light
string
车型图片链接(选中时)
必填
img_url_off_light
string
车型图片链接(未选中时)
必填
vehicle_std_arr
array
车型可选附加要求
必填
name
string
附加要求名称, 示例:全拆座
必填
desc
string
附加要求说明, 示例:有4个座椅,适⽤于多⼈跟⻋
必填
price_fen
number
收费(分)
必填
vehicle_price_text_item
object
计价规则明细
必填
start_distance_km
int
起步里程数(km) 示例:6
必填
start_price_fen
int
起步价格(分), 示例:3550
必填
exceed_segment_price
array
超里程价格
必填
start_exdistancekm
number
区间开始里程数(km) 示例:7
必填
end_exdistancekm
number
区间结束里程数(km) 示例:16
必填
price_extra_fen
number
区间内每公里收费(分), 示例:600
必填
price_fen_after_start
int
超过起步公里程后每公里收费(以分为单位)
必填
text_size
string
车厢长*宽*高(m), 示例:1.9*1.3*1.1
必填
text_volume
string
车厢体积, 示例:2.72方
必填
text_weight
string
车型最大载重(KG) 示例:载重:500公斤
必填
text_desc
string
车型描述, 示例:上货、卸货免费等候时长总共为40分钟,过后每10分钟加收5元,不足10分钟按10分钟计算。高速及停车场等费用,根据实际产生的金额由客户支付。
必填
surcharge_desc
string
附加费用描述,示例:
必填
carriage_length_cm
string
物理整车长度(cm)
必填
carriage_width_cm
string
物理整车宽度(cm)
必填
carriage_height_cm
string
物理整车高度(cm)
必填
is_truck_direction
int
是否为大车业务 0否,1是
必填
spec_req_arr
array
城市可选额外需求列表。
必填
type
int
额外需求id, 示例:2
必填
name
string
额外需求名称, 示例:小推车
必填
desc
string
额外需求描述,示例:(附加40%路费)
必填
price_type
int
计价类型(1-固定值计价, 2-百分⽐计价, 3-司机商议,4-免费 )
必填
price_value_fen
int
如果price_type=1,此处为具体价格; 如果 price_type=2, 此处为百分⽐⽐值价, 如果 price_type=3/4,此处为0
必填

request Body请求示例

```json { "app_key":"*****************", "access_token":"*******************", "nonce_str":"8sZD2c7raj", "timestamp":1564022849, "city_id":1002 } ```

response响应示例

```json { "ret": 0, "data": { "city_id": 1002, "name": "深圳", "name_en": "shenzhen", "vehicle_arr": [ { "order_vehicle_id": 5, "name": "小面包车", "vehicle_price_text_item": { "start_price_fen": 3550, "start_distance_km": 6, "price_fen_after_start": 0, "text_size": "1.9*1.3*1.1", "text_volume": "2.72方", "text_weight": "载重:500公斤", "text_desc": "上货、卸货免费等候时长总共为40分钟,过后每10分钟加收5元,不足10分钟按10分钟计算。高速及停车场等费用,根据实际产生的金额由客户支付。sdsdsdsdsdsds", "exceed_segment_price": [ { "start_exdistancekm": 7, "end_exdistancekm": 16, "price_extra_fen": 600 }, { "start_exdistancekm": 17, "end_exdistancekm": 26, "price_extra_fen": 400 }, { "start_exdistancekm": 27, "end_exdistancekm": 999999, "price_extra_fen": 360 } ] }, "vehicle_std_arr": [ { "name": "全拆座", "price_fen": 0, "desc": "载货空间更大" }, { "name": "高顶", "price_fen": 1000, "desc": "车厢高度略高于普通车型" }, { "name": "轻货", "price_fen": 0, "desc": "" } ], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_small_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_small_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "0", "carriage_width_cm": "0", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 7, "name": "小型厢货", "vehicle_price_text_item": { "start_price_fen": 3500, "start_distance_km": 6, "price_fen_after_start": 0, "text_size": "2.7*1.5*1.7", "text_volume": "6.89方", "text_weight": "载重:1.001吨", "text_desc": "上货、卸货免费等候时长总共为40分钟,过后每10分钟加收5元,不足10分钟按10分钟计算。高速及停车场等费用,根据实际产生的金额由客户支付。", "exceed_segment_price": [ { "start_exdistancekm": 7, "end_exdistancekm": 16, "price_extra_fen": 600 }, { "start_exdistancekm": 17, "end_exdistancekm": 31, "price_extra_fen": 500 }, { "start_exdistancekm": 32, "end_exdistancekm": 51, "price_extra_fen": 450 }, { "start_exdistancekm": 52, "end_exdistancekm": 999999, "price_extra_fen": 400 } ] }, "vehicle_std_arr": [ { "name": "双排座", "price_fen": 300, "desc": "有4个座椅,适用于多人跟车" } ], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/van_small_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/van_small_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "0", "carriage_width_cm": "0", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 8, "name": "小型平板", "vehicle_price_text_item": { "start_price_fen": 6250, "start_distance_km": 6, "price_fen_after_start": 0, "text_size": "15*8*5", "text_volume": "600.00方", "text_weight": "载重:1吨", "text_desc": "上货、卸货免费等候时长总共为40分钟,过后每10分钟加收5元,不足10分钟按10分钟计算。高速及停车场等费用,根据实际产生的金额由客户支付。", "exceed_segment_price": [ { "start_exdistancekm": 7, "end_exdistancekm": 999999, "price_extra_fen": 500 } ] }, "vehicle_std_arr": [ { "name": "双排座", "price_fen": 0, "desc": "有4个座椅,适用于多人跟车" }, { "name": "带尾板", "price_fen": 0, "desc": "液压起重装卸设备,方便装卸货" }, { "name": "限高2米", "price_fen": 0, "desc": "方便进地下车库" }, { "name": "平板货车", "price_fen": 0, "desc": "" } ], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/flat_bed_trailer_small_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/flat_bed_trailer_small_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "0", "carriage_width_cm": "0", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 241, "name": "牵引车", "vehicle_price_text_item": { "start_price_fen": 100, "start_distance_km": 1, "price_fen_after_start": 0, "text_size": "1*1*1", "text_volume": "1.00方", "text_weight": "载重:100公斤", "text_desc": "", "exceed_segment_price": [ { "start_exdistancekm": 2, "end_exdistancekm": 999999, "price_extra_fen": 100 } ] }, "vehicle_std_arr": [], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/van_test.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/van_test_off.png", "surcharge_desc": "", "carriage_length_cm": "0", "carriage_width_cm": "0", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 252, "name": "订单车型配置", "vehicle_price_text_item": { "start_price_fen": 1000, "start_distance_km": 1, "price_fen_after_start": 0, "text_size": "10*10*10", "text_volume": "1000.00方", "text_weight": "载重:200公斤", "text_desc": "", "exceed_segment_price": [ { "start_exdistancekm": 2, "end_exdistancekm": 999999, "price_extra_fen": 1000 } ] }, "vehicle_std_arr": [ { "name": "全拆座", "price_fen": 1000, "desc": "载货空间更大" } ], "img_url_high_light": "https://ops2-stg.huolala.cn/assets/img/flat_bed_trailer_big_6_8_chengji_v1.png", "img_url_off_light": "https://ops2-stg.huolala.cn/assets/img/flat_bed_trailer_big_6_8_chengji_v1_off.png", "surcharge_desc": "", "carriage_length_cm": "0", "carriage_width_cm": "0", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 260, "name": "8", "vehicle_price_text_item": { "start_price_fen": 800, "start_distance_km": 8, "price_fen_after_start": 0, "text_size": "8*8*8", "text_volume": "512.00方", "text_weight": "载重:8公斤", "text_desc": "", "exceed_segment_price": [ { "start_exdistancekm": 9, "end_exdistancekm": 999999, "price_extra_fen": 800 } ] }, "vehicle_std_arr": [], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/flat_bed_trailer_large_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/flat_bed_trailer_large_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "800", "carriage_width_cm": "800", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 261, "name": "9", "vehicle_price_text_item": { "start_price_fen": 900, "start_distance_km": 9, "price_fen_after_start": 0, "text_size": "9*9*9", "text_volume": "729.00方", "text_weight": "载重:9公斤", "text_desc": "9", "exceed_segment_price": [ { "start_exdistancekm": 10, "end_exdistancekm": 999999, "price_extra_fen": 900 } ] }, "vehicle_std_arr": [], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_small_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_small_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "0", "carriage_width_cm": "0", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 262, "name": "10", "vehicle_price_text_item": { "start_price_fen": 100, "start_distance_km": 1, "price_fen_after_start": 0, "text_size": "1*1*1", "text_volume": "1.00方", "text_weight": "载重:12公斤", "text_desc": "12", "exceed_segment_price": [ { "start_exdistancekm": 2, "end_exdistancekm": 999999, "price_extra_fen": 100 } ] }, "vehicle_std_arr": [ { "name": "全拆座", "price_fen": 100, "desc": "载货空间更大" }, { "name": "面包车", "price_fen": 200, "desc": "" } ], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_big_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_big_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "0", "carriage_width_cm": "0", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 263, "name": "11", "vehicle_price_text_item": { "start_price_fen": 100, "start_distance_km": 1, "price_fen_after_start": 0, "text_size": "1*1*1", "text_volume": "1.00方", "text_weight": "载重:12公斤", "text_desc": "", "exceed_segment_price": [ { "start_exdistancekm": 2, "end_exdistancekm": 999999, "price_extra_fen": 200 } ] }, "vehicle_std_arr": [ { "name": "面包车", "price_fen": 1100, "desc": "" } ], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_big_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_big_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "0", "carriage_width_cm": "0", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 264, "name": "12", "vehicle_price_text_item": { "start_price_fen": 200, "start_distance_km": 2, "price_fen_after_start": 0, "text_size": "2*2*2", "text_volume": "8.00方", "text_weight": "载重:22公斤", "text_desc": "", "exceed_segment_price": [ { "start_exdistancekm": 3, "end_exdistancekm": 999999, "price_extra_fen": 200 } ] }, "vehicle_std_arr": [], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_small_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_small_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "200", "carriage_width_cm": "200", "carriage_height_cm": "0", "is_truck_direction": 1 }, { "order_vehicle_id": 267, "name": "15", "vehicle_price_text_item": { "start_price_fen": 500, "start_distance_km": 5, "price_fen_after_start": 0, "text_size": "5*5*5", "text_volume": "125.00方", "text_weight": "载重:5公斤", "text_desc": "", "exceed_segment_price": [ { "start_exdistancekm": 6, "end_exdistancekm": 999999, "price_extra_fen": 500 } ] }, "vehicle_std_arr": [], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/van_big_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/van_big_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "500", "carriage_width_cm": "500", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 269, "name": "17", "vehicle_price_text_item": { "start_price_fen": 700, "start_distance_km": 7, "price_fen_after_start": 0, "text_size": "7*7*7", "text_volume": "343.00方", "text_weight": "载重:7公斤", "text_desc": "", "exceed_segment_price": [ { "start_exdistancekm": 8, "end_exdistancekm": 999999, "price_extra_fen": 700 } ] }, "vehicle_std_arr": [ { "name": "全拆座", "price_fen": 100, "desc": "载货空间更大" } ], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/small_goods_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/small_goods_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "10", "carriage_width_cm": "2000", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 242, "name": "小型厢货3", "vehicle_price_text_item": { "start_price_fen": 2000, "start_distance_km": 1, "price_fen_after_start": 0, "text_size": "4.2*2.3*2", "text_volume": "19.32方", "text_weight": "载重:3吨", "text_desc": "123123", "exceed_segment_price": [ { "start_exdistancekm": 2, "end_exdistancekm": 999999, "price_extra_fen": 200 } ] }, "vehicle_std_arr": [ { "name": "高顶", "price_fen": 1200, "desc": "车厢高度略高于普通车型" }, { "name": "轻货", "price_fen": 1200, "desc": "" } ], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/van_small_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/van_small_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "10", "carriage_width_cm": "10", "carriage_height_cm": "0", "is_truck_direction": 1 }, { "order_vehicle_id": 6, "name": "中面包车", "vehicle_price_text_item": { "start_price_fen": 7280, "start_distance_km": 6, "price_fen_after_start": 0, "text_size": "15*5*2", "text_volume": "150.00方", "text_weight": "载重:1吨", "text_desc": "上货、卸货免费等候时长总共为40分钟,过后每10分钟加收5元,不足10分钟按10分钟计算。高速及停车场等费用,根据实际产生的金额由客户支付。", "exceed_segment_price": [ { "start_exdistancekm": 7, "end_exdistancekm": 999999, "price_extra_fen": 500 } ] }, "vehicle_std_arr": [ { "name": "全拆座", "price_fen": 0, "desc": "载货空间更大" }, { "name": "高顶", "price_fen": 1000, "desc": "车厢高度略高于普通车型" }, { "name": "轻货", "price_fen": 0, "desc": "" } ], "img_url_high_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_big_v2.png", "img_url_off_light": "https://ops2-stg.huolala.cn/rs/dist/images/minibus_big_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "2000", "carriage_width_cm": "2100", "carriage_height_cm": "0", "is_truck_direction": 0 }, { "order_vehicle_id": 9, "name": "中货车", "vehicle_price_text_item": { "start_price_fen": 12500, "start_distance_km": 5, "price_fen_after_start": 0, "text_size": "4.2*1.8*1.8", "text_volume": "13.61方", "text_weight": "载重:1.8吨", "text_desc": "上货、卸货免费等候时长总共为60分钟,过后每15分钟加收10元,不足15分钟按15分钟计算。高速及停车场等费用,根据实际产生的金额由客户支付。", "exceed_segment_price": [ { "start_exdistancekm": 6, "end_exdistancekm": 15, "price_extra_fen": 1200 }, { "start_exdistancekm": 16, "end_exdistancekm": 999999, "price_extra_fen": 700 } ] }, "vehicle_std_arr": [ { "name": "带尾板", "price_fen": 2000, "desc": "液压起重装卸设备,方便装卸货" }, { "name": "覆盖蓬", "price_fen": 1000, "desc": "方便运输防晒防雨的货物" } ], "img_url_high_light": "https://ops2-pre.huolala.cn/rs/dist/images/van_big_v2.png", "img_url_off_light": "https://ops2-pre.huolala.cn/rs/dist/images/van_big_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "2000", "carriage_width_cm": "100", "carriage_height_cm": "0", "is_truck_direction": 1 }, { "order_vehicle_id": 268, "name": "16", "vehicle_price_text_item": { "start_price_fen": 600, "start_distance_km": 6, "price_fen_after_start": 0, "text_size": "6*6*6", "text_volume": "216.00方", "text_weight": "载重:6公斤", "text_desc": "6", "exceed_segment_price": [ { "start_exdistancekm": 7, "end_exdistancekm": 999999, "price_extra_fen": 600 } ] }, "vehicle_std_arr": [], "img_url_high_light": "https://ops2-pre.huolala.cn/rs/dist/images/flat_bed_trailer_large_v2.png", "img_url_off_light": "https://ops2-pre.huolala.cn/rs/dist/images/flat_bed_trailer_large_v2_off.png", "surcharge_desc": "", "carriage_length_cm": "600", "carriage_width_cm": "600", "carriage_height_cm": "0", "is_truck_direction": 1 } ], "spec_req_arr": [ { "type": 2, "price_type": 1, "name": "小推车", "desc": "小推车5元", "price_value_fen": 500 }, { "type": 3, "price_type": 4, "name": "纸质回单", "desc": "纸质回单免费", "price_value_fen": 0 }, { "type": 5, "price_type": 2, "name": "返程", "desc": "附加40%路费", "price_value_fen": 40 }, { "type": 6, "price_type": 4, "name": "拍照回单", "desc": "免费", "price_value_fen": 0 }, { "type": 7, "price_type": 4, "name": "海运入仓", "desc": "司机另议当官的当官帝国但", "price_value_fen": 0 }, { "type": 8, "price_type": 1, "name": "代收货款", "desc": "123456789012", "price_value_fen": 500 }, { "type": 1, "price_type": 1, "name": "搬运", "desc": "搬运费", "price_value_fen": 800 } ], "revision": 777 }, "msg": "Success" } ```

返回状态码

|状态码|描述| |-|-|-| |0|成功| |1|服务器异常| |1000|传输参数异常| |21001|当前城市暂无车型|

调用特别注意事项

1.请特别保存返回值“城市版本号revision”,因为后续计价,下单都需要传入此字段并验证; 2.如果不是最新的城市版本号,下单将直接报错; 3.请再次通过此接口获取到最新的城市版本号,并重新计价;