淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
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。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
rent_car_b2b_product_list_req	RentCarB2bProductListReq	可选			入参
└ car_use_time Date 可选 2022-11-11 10:11:21 用车时间 return_info RentCarAddressInfo 可选用户搜索还车位置点信息 └ city_code String 可选 411100 城市code └ name String 可选漯河高铁站位置 └ location String 可选 12.123123,12.123241 位置经Longitude纬度Latitude。格式：经度,纬度 └ trace_id String 可选 2107651717161955704572674e34b8 排查问题用的id pick_up_info RentCarAddressInfo 可选用户搜索取车位置点信息 └ city_code String 可选 411100 城市code └ name String 可选漯河高铁站位置 └ location String 可选 12.123123,12.123241 位置经Longitude纬度Latitude。格式：经度,纬度 └ car_return_time Date 可选 2022-11-11 10:11:21 还车时间 └ exts String 可选 {"key":"value"} 扩展参数 └ channel_id String 必须 80001 渠道ID active_info ActiveInfo [] 可选活动信息(用于分销和飞猪做活动显示调用场景必传) 活动信息(用于分销和飞猪做活动显示调用场景必传) └ active_id String 可选 1102299933 活动ID └ usage_quantity Number 可选 1 使用数量

名称	类型	示例值	描述
successful	Boolean	true	请求是否成功
rent_car_stores	RentCarStore []		租车门店列表
└ store_type Number 1 门店类型，1-门店，2-提车点 └ address String 漯河高铁站广场豫州租车门店详细地址 └ code String 112233 门店代码 └ city_name String 漯河所在城市名称 └ latitude String 33.572128 纬度 └ open_times String 00:00-07:59,08:00-20:59,21:00-23:59 营业时间,多段逗号分隔 └ name String 豫州租车漯河西站店门店名称 └ telephones String 19999999999 联系电话，支持多个，用逗号分隔 └ sid String 10583 飞猪标准门店id └ city_code String 411100 所在城市code └ longitude String 113.965189 经度
ret_code	String	1001	返回错误码
rent_cars	RentCarInfo []		车辆信息
└ car_name String 陆上公务舱 652T 豪华型车款 └ output_type Number 1 排量类型，1-T，2-L └ output_volume String 2.0 排量值 └ type Number 6 车辆分类 └ model_year String 2021 车型年份（国内租车专用）eg:2017 └ door_num Number 5 车门数 └ auto_brand String 别克汽车品牌名 └ transmission Number 1 变数箱类型，国际租车：1-手动，2-自动。国内租车：1-手动，2-自动，3-手自一体 └ seat_num Number 7 座位数 └ fuel_type Number 1 燃油类型，枚举值:1燃油 2混动 3纯电动 └ name String GL8 车辆名称，即车型 └ pics String xxx.png 车型图片，可有多张，用逗号分隔 └ sid String 11137 飞猪标准车型id
rent_car_suppliers	RentCarSupplier []		供应商信息
└ brand_desc String 飞猪租车,安心租品牌介绍，图文描述 └ name String 飞猪租车品牌名称（中文） └ id String 1 品牌id，目前是以品牌英文名称作为其id标识 └ pic String xxx.png 品牌图片 └ tags String 1,2 品牌标签，标签之间用逗号隔开,104 全国异地还车; 17 24小时营业; 10000 品牌; 10010 精选标签; 44 安心租; 10023 优选商家; 10026 最近浏览; 10031 全国连锁; └ comment_score String 100 评论分 └ comment_num Number 1 评论数量
rent_car_prices	RentCarPriceInfo []		车辆报价信息
└ supplier_id String 1 供应商id，可选，余留 └ cancel_type Number 102 取消类型 101：免费取消-取车时间前可免费取消。 102：限时免费取消-取车前X小时可免费取消；取车前X小时-取车时间取消扣订单总金额X%；取车时间后取消扣订单全额。 103：有损取消-该订单付款后取消，需扣订单总金额X% └ return_store_sid String 10583 还车门店id（飞猪标准门店id） └ on_door_fee String 123.00 上门送取车费用总金额（收费上门送取车时必传）,单位元上门取车费（pickUpOnDoorFee）+上门还车费（returnOnDoorFee） └ basic_service_fee String 123.00 基础服务费(总费用),单位元 └ poundage_fee String 231.00 手续费(总费用),单位元 └ rent_fee String 123.00 租车费 = quantity * unitPrice，车辆基本租金，人民币，单位元，必填 └ tags String 33,44,35,22 tags, 1 信用免押·免车辆押金; 2 信用免押·免违章押金; 3 押金双免; 4 送车上门; 5 上门取车; 6 上门取送; 7 快速取还; 8 车况佳; 9 满油取还; 10 3万公里内新车; 11 3公里内免费接送; 12 支持异地还车; 13 新款车; 14 配手机支架; 15 老款车; 16 免费接至门店取车; 17 24小时营业 18 倒车雷达; 19 服务专业; 20 配纸巾; 21 配饮用水; 22 配充电线; 23 取还便捷; 24 快速取; 25 儿童座椅; 26 倒车影像; 27 配行车记录仪; 28 5公里内免费接送; 29 无需等待; 30 一车一洗; 31 免费上门取送车; 32 一年内新车; 33 两年内新车; 34 三年内新车; 35 实时结算; 36 能源免费; 37 纯电动; 38 旅行车; 39 半年内新车; 40 油量保障; 41 不限里程; 42 支持港澳台证件; 43 五年内新车; 44 安心租; 45 免费雪地胎; 46 可提供ETC; 47 免费送口罩; 100 立即确认; 101 免费取消; 102 限时免费取消; 103 有损取消; 104 全国异地还车;105一口价;106送车损无忧; └ car_sid String 11137 车型id（飞猪标准车型id） └ total_fee String 1061 报价总租金(如果有优惠则优惠后)人民币，单位元，必填 └ item_id String eJxGwQkBACEIBMAwFoDlkyAXQET6R7gZ+oJIZQGsniaGANZcHGytmg4PlyeT5JbTG5WMlcxHFVevd+MhvO6pftuMRgI/pQUWSg== 商品报价唯一ID └ hour_feee String 0 零散小时费总金额,单位元 eg:38.09 └ origin_unit_price String 0 日租金,单位元，标准价车辆租金单价 └ pick_up_store_sid String 10583 取车门店ID └ stock_num Number 1 库存数 └ one_way_fee String 100.00 异地还车费 └ origin_total_fee String 100.00 原始报价（优惠前总租金）人民币，单位元，必填 └ unit_price String 100.00 优惠后日租金,单位元，标准价车辆租金单价，单位元 └ quantity String 2.0 租期，例如2.0,3.5 └ car_license Number 1 牌照类型，0-不限，1-本地牌，2外地牌 └ car_license_desc String 鲁B9121 牌照描述 └ pick_up_car_type String 1 取车类型1:"免费上门送取车"，2:"收费上门送取车",3:"自行前往门店取取车",4:"店员免费接您至门店取取车" └ return_car_type String 1 还车类型1:"免费上门送还车",2:"收费上门送还车",3:"自行前往门店取还车",4:"店员免费接您至门店取还车" promotion PromotionInfo 商家优惠信息,只保留最大优惠 └ code String aaa01 优惠code └ name String 促销优惠信息名称 └ desc String 促销活动优惠活动的描述 └ off_value String 50 优惠金额 └ type Number 1 优惠1:总租金;2:日租金 └ investor Number 1 出资方:1-分销商优惠2-飞猪优惠 └ pick_up_on_door_fee String 12.90 上门取车费 └ return_on_door_fee String 12.99 上门还车费 └ car_pre_deposit String 2000.00 车辆押金，单位元（3000元） └ legal_pre_deposit String 2000.00 违章押金，单位元（2000）
exts	Json	k:v	扩展字段
ret_msg	String	查询报价错误	错误原因

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripRentcarBtbPriceQueryRequest req = new AlitripRentcarBtbPriceQueryRequest();
AlitripRentcarBtbPriceQueryRequest.RentCarB2bProductListReq obj1 = new AlitripRentcarBtbPriceQueryRequest.RentCarB2bProductListReq();
obj1.setCarUseTime(StringUtils.parseDateTime("2022-11-11 10:11:21"));
AlitripRentcarBtbPriceQueryRequest.RentCarAddressInfo obj2 = new AlitripRentcarBtbPriceQueryRequest.RentCarAddressInfo();
obj2.setCityCode("411100");
obj2.setName("漯河高铁站");
obj2.setLocation("12.123123,12.123241");
obj1.setReturnInfo(obj2);
obj1.setTraceId("2107651717161955704572674e34b8");
AlitripRentcarBtbPriceQueryRequest.RentCarAddressInfo obj3 = new AlitripRentcarBtbPriceQueryRequest.RentCarAddressInfo();
obj3.setCityCode("411100");
obj3.setName("漯河高铁站");
obj3.setLocation("12.123123,12.123241");
obj1.setPickUpInfo(obj3);
obj1.setCarReturnTime(StringUtils.parseDateTime("2022-11-11 10:11:21"));
obj1.setExts("{\"key\":\"value\"}");
obj1.setChannelId("80001");
List<AlitripRentcarBtbPriceQueryRequest.ActiveInfo> list5 = new ArrayList<AlitripRentcarBtbPriceQueryRequest.ActiveInfo>();
AlitripRentcarBtbPriceQueryRequest.ActiveInfo obj6 = new AlitripRentcarBtbPriceQueryRequest.ActiveInfo();
list5.add(obj6);
obj6.setActiveId("1102299933");
obj6.setUsageQuantity(1L);
obj1.setActiveInfo(list5);
req.setRentCarB2bProductListReq(obj1);
AlitripRentcarBtbPriceQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripRentcarBtbPriceQueryRequest req = new AlitripRentcarBtbPriceQueryRequest();
AlitripRentcarBtbPriceQueryRequest.RentCarB2bProductListReqDomain obj1 = new AlitripRentcarBtbPriceQueryRequest.RentCarB2bProductListReqDomain();
obj1.CarUseTime = DateTime.Parse(2022-11-11 10:11:21");
AlitripRentcarBtbPriceQueryRequest.RentCarAddressInfoDomain obj2 = new AlitripRentcarBtbPriceQueryRequest.RentCarAddressInfoDomain();
obj2.CityCode = "411100";
obj2.Name = "漯河高铁站";
obj2.Location = "12.123123,12.123241";
obj1.ReturnInfo= obj2;
obj1.TraceId = "2107651717161955704572674e34b8";
AlitripRentcarBtbPriceQueryRequest.RentCarAddressInfoDomain obj3 = new AlitripRentcarBtbPriceQueryRequest.RentCarAddressInfoDomain();
obj3.CityCode = "411100";
obj3.Name = "漯河高铁站";
obj3.Location = "12.123123,12.123241";
obj1.PickUpInfo= obj3;
obj1.CarReturnTime = DateTime.Parse(2022-11-11 10:11:21");
obj1.Exts = "{\"key\":\"value\"}";
obj1.ChannelId = "80001";
List<AlitripRentcarBtbPriceQueryRequest.ActiveInfoDomain> list5 = new List<AlitripRentcarBtbPriceQueryRequest.ActiveInfoDomain>();
AlitripRentcarBtbPriceQueryRequest.ActiveInfoDomain obj6 = new AlitripRentcarBtbPriceQueryRequest.ActiveInfoDomain();
list5.Add(obj6);
obj6.ActiveId = "1102299933";
obj6.UsageQuantity = 1L;
obj1.ActiveInfo= list5;
req.RentCarB2bProductListReq_ = obj1;
AlitripRentcarBtbPriceQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripRentcarBtbPriceQueryRequest;
$rent_car_b2b_product_list_req = new RentCarB2bProductListReq;
$rent_car_b2b_product_list_req->car_use_time="2022-11-11 10:11:21";
$return_info = new RentCarAddressInfo;
$return_info->city_code="411100";
$return_info->name="漯河高铁站";
$return_info->location="12.123123,12.123241";
$rent_car_b2b_product_list_req->return_info = $return_info;
$rent_car_b2b_product_list_req->trace_id="2107651717161955704572674e34b8";
$pick_up_info = new RentCarAddressInfo;
$pick_up_info->city_code="411100";
$pick_up_info->name="漯河高铁站";
$pick_up_info->location="12.123123,12.123241";
$rent_car_b2b_product_list_req->pick_up_info = $pick_up_info;
$rent_car_b2b_product_list_req->car_return_time="2022-11-11 10:11:21";
$rent_car_b2b_product_list_req->exts="{\"key\":\"value\"}";
$rent_car_b2b_product_list_req->channel_id="80001";
$active_info = new ActiveInfo;
$active_info->active_id="1102299933";
$active_info->usage_quantity="1";
$rent_car_b2b_product_list_req->active_info = $active_info;
$req->setRentCarB2bProductListReq(json_encode($rent_car_b2b_product_list_req));
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alitrip.rentcar.btb.price.query' \
-d 'partner_id=apidoc' \
-d 'sign=213A10393438E342B2B60FD10CEE2C2C' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+16%3A55%3A54' \
-d 'v=2.0' \
-d 'rent_car_b2b_product_list_req=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlitripRentcarBtbPriceQueryRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.rent_car_b2b_product_list_req="数据结构示例JSON格式"
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alitrip.rentcar.btb.price.query");
add_param(pRequest,"rent_car_b2b_product_list_req","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alitrip.rentcar.btb.price.query', {
	'rent_car_b2b_product_list_req':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_rentcar_btb_price_query_response>
    <successful>true</successful>
    <rent_car_stores>
        <rent_car_store>
            <store_type>1</store_type>
            <address>漯河高铁站广场豫州租车门店</address>
            <code>112233</code>
            <city_name>漯河</city_name>
            <latitude>33.572128</latitude>
            <open_times>00:00-07:59,08:00-20:59,21:00-23:59</open_times>
            <name>豫州租车漯河西站店</name>
            <telephones>19999999999</telephones>
            <sid>10583</sid>
            <city_code>411100</city_code>
            <longitude>113.965189</longitude>
        </rent_car_store>
    </rent_car_stores>
    <ret_code>1001</ret_code>
    <rent_cars>
        <rent_car_info>
            <car_name>陆上公务舱 652T 豪华型</car_name>
            <output_type>1</output_type>
            <output_volume>2.0</output_volume>
            <type>6</type>
            <model_year>2021</model_year>
            <door_num>5</door_num>
            <auto_brand>别克</auto_brand>
            <transmission>1</transmission>
            <seat_num>7</seat_num>
            <fuel_type>1</fuel_type>
            <name>GL8</name>
            <pics>xxx.png</pics>
            <sid>11137</sid>
        </rent_car_info>
    </rent_cars>
    <rent_car_suppliers>
        <rent_car_supplier>
            <brand_desc>飞猪租车,安心租</brand_desc>
            <name>飞猪租车</name>
            <id>1</id>
            <pic>xxx.png</pic>
            <tags>1,2</tags>
            <comment_score>100</comment_score>
            <comment_num>1</comment_num>
        </rent_car_supplier>
    </rent_car_suppliers>
    <rent_car_prices>
        <rent_car_price_info>
            <supplier_id>1</supplier_id>
            <cancel_type>102</cancel_type>
            <return_store_sid>10583</return_store_sid>
            <on_door_fee>123.00</on_door_fee>
            <basic_service_fee>123.00</basic_service_fee>
            <poundage_fee>231.00</poundage_fee>
            <rent_fee>123.00</rent_fee>
            <tags>33,44,35,22</tags>
            <car_sid>11137</car_sid>
            <total_fee>1061</total_fee>
            <item_id>eJxGwQkBACEIBMAwFoDlkyAXQET6R7gZ+oJIZQGsniaGANZcHGytmg4PlyeT5JbTG5WMlcxHFVevd+MhvO6pftuMRgI/pQUWSg==</item_id>
            <hour_feee>0</hour_feee>
            <origin_unit_price>0</origin_unit_price>
            <pick_up_store_sid>10583</pick_up_store_sid>
            <stock_num>1</stock_num>
            <one_way_fee>100.00</one_way_fee>
            <origin_total_fee>100.00</origin_total_fee>
            <unit_price>100.00</unit_price>
            <quantity>2.0</quantity>
            <car_license>1</car_license>
            <car_license_desc>鲁B9121</car_license_desc>
            <pick_up_car_type>1</pick_up_car_type>
            <return_car_type>1</return_car_type>
            <promotion>
                <code>aaa01</code>
                <name>促销</name>
                <desc>促销活动</desc>
                <off_value>50</off_value>
                <type>1</type>
                <investor>1</investor>
            </promotion>
            <pick_up_on_door_fee>12.90</pick_up_on_door_fee>
            <return_on_door_fee>12.99</return_on_door_fee>
            <car_pre_deposit>2000.00</car_pre_deposit>
            <legal_pre_deposit>2000.00</legal_pre_deposit>
        </rent_car_price_info>
    </rent_car_prices>
    <exts>k:v</exts>
    <ret_msg>查询报价错误</ret_msg>
</alitrip_rentcar_btb_price_query_response>

{
    "alitrip_rentcar_btb_price_query_response":{
        "successful":true,
        "rent_car_stores":{
            "rent_car_store":[
                {
                    "store_type":1,
                    "address":"漯河高铁站广场豫州租车门店",
                    "code":"112233",
                    "city_name":"漯河",
                    "latitude":"33.572128",
                    "open_times":"00:00-07:59,08:00-20:59,21:00-23:59",
                    "name":"豫州租车漯河西站店",
                    "telephones":"19999999999",
                    "sid":"10583",
                    "city_code":"411100",
                    "longitude":"113.965189"
                }
            ]
        },
        "ret_code":"1001",
        "rent_cars":{
            "rent_car_info":[
                {
                    "car_name":"陆上公务舱 652T 豪华型",
                    "output_type":1,
                    "output_volume":"2.0",
                    "type":6,
                    "model_year":"2021",
                    "door_num":5,
                    "auto_brand":"别克",
                    "transmission":1,
                    "seat_num":7,
                    "fuel_type":1,
                    "name":"GL8",
                    "pics":"xxx.png",
                    "sid":"11137"
                }
            ]
        },
        "rent_car_suppliers":{
            "rent_car_supplier":[
                {
                    "brand_desc":"飞猪租车,安心租",
                    "name":"飞猪租车",
                    "id":"1",
                    "pic":"xxx.png",
                    "tags":"1,2",
                    "comment_score":"100",
                    "comment_num":1
                }
            ]
        },
        "rent_car_prices":{
            "rent_car_price_info":[
                {
                    "supplier_id":"1",
                    "cancel_type":102,
                    "return_store_sid":"10583",
                    "on_door_fee":"123.00",
                    "basic_service_fee":"123.00",
                    "poundage_fee":"231.00",
                    "rent_fee":"123.00",
                    "tags":"33,44,35,22",
                    "car_sid":"11137",
                    "total_fee":"1061",
                    "item_id":"eJxGwQkBACEIBMAwFoDlkyAXQET6R7gZ+oJIZQGsniaGANZcHGytmg4PlyeT5JbTG5WMlcxHFVevd+MhvO6pftuMRgI\/pQUWSg==",
                    "hour_feee":"0",
                    "origin_unit_price":"0",
                    "pick_up_store_sid":"10583",
                    "stock_num":1,
                    "one_way_fee":"100.00",
                    "origin_total_fee":"100.00",
                    "unit_price":"100.00",
                    "quantity":"2.0",
                    "car_license":1,
                    "car_license_desc":"鲁B9121",
                    "pick_up_car_type":"1",
                    "return_car_type":"1",
                    "promotion":{
                        "code":"aaa01",
                        "name":"促销",
                        "desc":"促销活动",
                        "off_value":"50",
                        "type":1,
                        "investor":1
                    },
                    "pick_up_on_door_fee":"12.90",
                    "return_on_door_fee":"12.99",
                    "car_pre_deposit":"2000.00",
                    "legal_pre_deposit":"2000.00"
                }
            ]
        },
        "exts":"k:v",
        "ret_msg":"查询报价错误"
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

旅行用车API

alitrip.rentcar.btb.price.query (租车分销搜索报价接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ