淘宝开放平台 - 文档中心

请求地址：

环境	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_renewal_detail_req	RentCarB2bRenewalDetailReq	可选			入参
└ car_use_time Date 可选 2022-11-22 10:00:00 续租取车时间 └ trace_id String 可选 2147b72e16691938918672871ef815 排查问题 └ order_id Number 可选 352412312123123 飞猪主订单id └ car_return_time Date 可选 2022-11-23 10:00:00 续租还车时间 └ renewal_order_id Number 可选 352412312123123 传飞猪续租订单ID(如果有续租，则为上一次续租的订单号,如果没有续租，则为null) └ exts String 可选 {"key":"value"} 扩展字段 └ channel_id String 必须 80001 渠道id

名称	类型	示例值	描述
item_id	String	eJwwwQEBBCEIBMAwFgAEFoJ8AEHsH+F+hn7wvyXCsgXKTharmzFHX21LvZ6CnMaLSQo+resSaeXjGPY9ODydoJK6EWbWH64NFmI=	报价唯一ID(快照ID)
price_info	RentCarDetailPriceInfo		价格信息
calendar_price DailyPriceInfo [] 日租金详情列表,显示每日租金+零散小时的天报价(零散小时收费和不收费两种情况,不收费空item,没有价格等信息),小于一天不用返回日租金详情列表,按基础价格展示,大于一天整天情况返回日租金详情列表,没有scatteredMinutes,scatteredPrice,大于一天整天有零散小时情况返回日租金详情列表,零散小时那天加上字段返回scatteredMinutes,scatteredPrice └ date Date 2022-11-22 每日租期 └ day_price String 20.5 每日租金,单位:(元有小数)，此字段为日租金,收零散小时费，此字段为日租金,不收零散小时费，此字段为空 └ scattered_price String 3 收零散小时费，此字段有值,不收零散小时费，此字段为空 └ scattered_minutes Number 1 零散分钟价格，整日为null,单位:(元有小数),零散分钟，整日为null,收零散小时费，此字段有值,只有有零散小时费的时候此字段有值,不收零散小时费，此字段为空, └ legal_deposit_time_out Number 20 违章押金解押超时时间,单位天 └ on_door_fee String 15.00 上门送取车费用总金额（收费上门送取车时必传）,单位元 eg:15.00,上门取车费(pickUpOnDoorFee) + 上门还车费(returnOnDoorFee) └ car_license_desc String 京牌、沪A、粤A 牌照描述 └ car_license Number 0-不限，1-本地牌，2-外地牌牌照类型 └ return_car_type String 1 还车类型,1:"免费上门送还车",2:"收费上门送还车",3:"自行前往门店取还车",4:"店员免费接您至门店取还车" └ hour_fee String 38.09 零散小时费总金额,单位元 eg:38.09 └ one_way_fee String 300.00 异地还车费，人民币，单位元 └ car_pre_deposit String 2000 车辆押金，单位元 └ unit_price String 150 优惠后日租金,单位元,标准价车辆租金单价，单位元 └ car_pre_deposit_time_out Number 15 车损解押超时时间,单位天,0还车后解押，15是还车后15天解押。 └ quantity String 2.0 租期，例如2.0,3.5 └ legal_pre_deposit String 2000 违章押金，单位元（如商家传递为空，默认2000元） └ return_on_door_fee String 12.90 上门还车费,单位元,e.g:12.90 └ pick_up_on_door_fee String 12.90 上门取车费,单位元,e.g:12.90 └ basic_service_fee String 20.00 基础服务费(总费用),单位元 └ origin_unit_price String 100.00 日租金,单位元,标准价车辆租金单价，单位元 └ rent_fee String 100.00 标准价车辆租金总价（单价租期）租车费=(quantity unitPrice),单位元 └ poundage_fee String 2000.00 手续费(总费用),单位元 └ tags String 2,3,5 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 送车损无忧 └ origin_total_fee String 200.00 原始报价(优惠前总租金),人民币，单位元，必填 └ total_fee String 200.00 报价总租金(如果有优惠则优惠后),人民币，单位元，必填 scattered_price_rule_info ScatteredPriceRuleInfo 零散小时费规则 data ScatteredPriceRule [] 零散小时费规则集合 └ start_time Number 0 开始分钟 └ end_time Number 240 结束分钟 └ value String 20 值，目前仅支持百分比，20% -> 20 └ pick_up_car_type String 1 取车类型1:"免费上门送取车", 2:"收费上门送取车", 3:"自行前往门店取取车", 4:"店员免费接您至门店取取车" promotion PromotionInfo 商家优惠信息 └ investor Number 2 出资方。1-分销商优惠 2-飞猪优惠 └ code String tripSingleMixPromotion-66373686506_947524608948 优惠CODE └ off_value String 20.00 优惠金额,单位元 └ name String 飞猪优惠优惠信息名称 └ type Number 1 优惠类型 1:总租金(订单金额)，2：日租金(按天优惠) └ desc String 已减20.01 优惠活动的描述
successful	Boolean	true	请求是否成功
ret_code	String	012	错误码
added_service_list	AddedService []		增值服务列表
└ service_desc String 夜间取车收取的服务费用增值服务描述 └ service_quantity String 1 增值服务数量 └ service_price String 30.00 增值服务单价,人民币，单位元 └ list_exclude String [] 不包含增值服务说明 └ is_one_way_fee Number 1 是否一口价，0-否，1-是。如果是一口价，即下单时候计算金额不会乘以天数。 └ list_include String [] 包含增值服务说明 └ service_price_amount String 40.00 增值服务总价，人民币，单位元 └ service_name String 夜间服务费增值服务名称 └ is_fixed Number 1 是否必选服务，必选服务不能取消选择,0-非必选，1-必选 └ sid String 34 飞猪商家增值服务标准编码
cancel_strategy_struct	CancelStrategyStruct		取消政策
cancel_rules CancelRule [] 具体取消收费规则 └ num Number 50 收取的取消费用，纯数字，具体单位详见cancelType └ time Number 30 具体取消收费规则。示例 "cancelRules":[ {"num":0,"time":2}, {"num":30.0,"time":0}, {"num":100,"time":-999999}] 表示用车前两小时取消不收违约金。两小时内收取30%的违约金。用车时间后取消收取100%的违约金 └ manual_check_time Number 0 取消用车时，取车前多久时间取消需要商家进行人工审核，单位：小时。如果不需要人工审核，则该值设置为0，表示取车时间前都可直接取消 └ cancel_type Number 2 取消类型。1-按照订单金额百分比收取取消费用，2-按照固定金额收取取消费用，单位:元 └ support_cancel Boolean true 是否支持取消。true-支持，false-不支持。
exts	Json	{"key":"value"}	预留扩展信息，KV对形式
ret_msg	String	orderId为空	错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripRentcarBtbRenewaldetailQueryRequest req = new AlitripRentcarBtbRenewaldetailQueryRequest();
AlitripRentcarBtbRenewaldetailQueryRequest.RentCarB2bRenewalDetailReq obj1 = new AlitripRentcarBtbRenewaldetailQueryRequest.RentCarB2bRenewalDetailReq();
obj1.setCarUseTime(StringUtils.parseDateTime("2022-11-22 10:00:00"));
obj1.setTraceId("2147b72e16691938918672871ef815");
obj1.setOrderId(352412312123123L);
obj1.setCarReturnTime(StringUtils.parseDateTime("2022-11-23 10:00:00"));
obj1.setRenewalOrderId(352412312123123L);
obj1.setExts("{\"key\":\"value\"}");
obj1.setChannelId("80001");
req.setRentCarB2bRenewalDetailReq(obj1);
AlitripRentcarBtbRenewaldetailQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripRentcarBtbRenewaldetailQueryRequest req = new AlitripRentcarBtbRenewaldetailQueryRequest();
AlitripRentcarBtbRenewaldetailQueryRequest.RentCarB2bRenewalDetailReqDomain obj1 = new AlitripRentcarBtbRenewaldetailQueryRequest.RentCarB2bRenewalDetailReqDomain();
obj1.CarUseTime = DateTime.Parse(2022-11-22 10:00:00");
obj1.TraceId = "2147b72e16691938918672871ef815";
obj1.OrderId = 352412312123123L;
obj1.CarReturnTime = DateTime.Parse(2022-11-23 10:00:00");
obj1.RenewalOrderId = 352412312123123L;
obj1.Exts = "{\"key\":\"value\"}";
obj1.ChannelId = "80001";
req.RentCarB2bRenewalDetailReq_ = obj1;
AlitripRentcarBtbRenewaldetailQueryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripRentcarBtbRenewaldetailQueryRequest;
$rent_car_b2b_renewal_detail_req = new RentCarB2bRenewalDetailReq;
$rent_car_b2b_renewal_detail_req->car_use_time="2022-11-22 10:00:00";
$rent_car_b2b_renewal_detail_req->trace_id="2147b72e16691938918672871ef815";
$rent_car_b2b_renewal_detail_req->order_id="352412312123123";
$rent_car_b2b_renewal_detail_req->car_return_time="2022-11-23 10:00:00";
$rent_car_b2b_renewal_detail_req->renewal_order_id="352412312123123";
$rent_car_b2b_renewal_detail_req->exts="{\"key\":\"value\"}";
$rent_car_b2b_renewal_detail_req->channel_id="80001";
$req->setRentCarB2bRenewalDetailReq(json_encode($rent_car_b2b_renewal_detail_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.renewaldetail.query' \
-d 'partner_id=apidoc' \
-d 'sign=B805D0E805F5CDC6FE401C23AC615267' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-29+17%3A14%3A10' \
-d 'v=2.0' \
-d 'rent_car_b2b_renewal_detail_req=null'

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

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

req.rent_car_b2b_renewal_detail_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.renewaldetail.query");
add_param(pRequest,"rent_car_b2b_renewal_detail_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.renewaldetail.query', {
	'rent_car_b2b_renewal_detail_req':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_rentcar_btb_renewaldetail_query_response>
    <item_id>eJwwwQEBBCEIBMAwFgAEFoJ8AEHsH+F+hn7wvyXCsgXKTharmzFHX21LvZ6CnMaLSQo+resSaeXjGPY9ODydoJK6EWbWH64NFmI=</item_id>
    <price_info>
        <calendar_price>
            <daily_price_info>
                <date>2022-11-22</date>
                <day_price>20.5</day_price>
                <scattered_price>3</scattered_price>
                <scattered_minutes>1</scattered_minutes>
            </daily_price_info>
        </calendar_price>
        <legal_deposit_time_out>20</legal_deposit_time_out>
        <on_door_fee>15.00</on_door_fee>
        <car_license_desc>京牌、沪A、粤A</car_license_desc>
        <car_license>0-不限，1-本地牌，2-外地牌</car_license>
        <return_car_type>1</return_car_type>
        <hour_fee>38.09</hour_fee>
        <one_way_fee>300.00</one_way_fee>
        <car_pre_deposit>2000</car_pre_deposit>
        <unit_price>150</unit_price>
        <car_pre_deposit_time_out>15</car_pre_deposit_time_out>
        <quantity>2.0</quantity>
        <legal_pre_deposit>2000</legal_pre_deposit>
        <return_on_door_fee>12.90</return_on_door_fee>
        <pick_up_on_door_fee>12.90</pick_up_on_door_fee>
        <basic_service_fee>20.00</basic_service_fee>
        <origin_unit_price>100.00</origin_unit_price>
        <rent_fee>100.00</rent_fee>
        <poundage_fee>2000.00</poundage_fee>
        <tags>2,3,5</tags>
        <origin_total_fee>200.00</origin_total_fee>
        <total_fee>200.00</total_fee>
        <scattered_price_rule_info>
            <data>
                <scattered_price_rule>
                    <start_time>0</start_time>
                    <end_time>240</end_time>
                    <value>20</value>
                </scattered_price_rule>
            </data>
        </scattered_price_rule_info>
        <pick_up_car_type>1</pick_up_car_type>
        <promotion>
            <investor>2</investor>
            <code>tripSingleMixPromotion-66373686506_947524608948</code>
            <off_value>20.00</off_value>
            <name>飞猪优惠</name>
            <type>1</type>
            <desc>已减20.01</desc>
        </promotion>
    </price_info>
    <successful>true</successful>
    <ret_code>012</ret_code>
    <added_service_list>
        <added_service>
            <service_desc>夜间取车收取的服务费用</service_desc>
            <service_quantity>1</service_quantity>
            <service_price>30.00</service_price>
            <is_one_way_fee>1</is_one_way_fee>
            <service_price_amount>40.00</service_price_amount>
            <service_name>夜间服务费</service_name>
            <is_fixed>1</is_fixed>
            <sid>34</sid>
        </added_service>
    </added_service_list>
    <cancel_strategy_struct>
        <cancel_rules>
            <cancel_rule>
                <num>50</num>
                <time>30</time>
            </cancel_rule>
        </cancel_rules>
        <manual_check_time>0</manual_check_time>
        <cancel_type>2</cancel_type>
        <support_cancel>true</support_cancel>
    </cancel_strategy_struct>
    <exts>{&quot;key&quot;:&quot;value&quot;}</exts>
    <ret_msg>orderId为空</ret_msg>
</alitrip_rentcar_btb_renewaldetail_query_response>

{
    "alitrip_rentcar_btb_renewaldetail_query_response":{
        "item_id":"eJwwwQEBBCEIBMAwFgAEFoJ8AEHsH+F+hn7wvyXCsgXKTharmzFHX21LvZ6CnMaLSQo+resSaeXjGPY9ODydoJK6EWbWH64NFmI=",
        "price_info":{
            "calendar_price":{
                "daily_price_info":[
                    {
                        "date":"2022-11-22",
                        "day_price":"20.5",
                        "scattered_price":"3",
                        "scattered_minutes":1
                    }
                ]
            },
            "legal_deposit_time_out":20,
            "on_door_fee":"15.00",
            "car_license_desc":"京牌、沪A、粤A",
            "car_license":0-不限，1-本地牌，2-外地牌,
            "return_car_type":"1",
            "hour_fee":"38.09",
            "one_way_fee":"300.00",
            "car_pre_deposit":"2000",
            "unit_price":"150",
            "car_pre_deposit_time_out":15,
            "quantity":"2.0",
            "legal_pre_deposit":"2000",
            "return_on_door_fee":"12.90",
            "pick_up_on_door_fee":"12.90",
            "basic_service_fee":"20.00",
            "origin_unit_price":"100.00",
            "rent_fee":"100.00",
            "poundage_fee":"2000.00",
            "tags":"2,3,5",
            "origin_total_fee":"200.00",
            "total_fee":"200.00",
            "scattered_price_rule_info":{
                "data":{
                    "scattered_price_rule":[
                        {
                            "start_time":0,
                            "end_time":240,
                            "value":"20"
                        }
                    ]
                }
            },
            "pick_up_car_type":"1",
            "promotion":{
                "investor":2,
                "code":"tripSingleMixPromotion-66373686506_947524608948",
                "off_value":"20.00",
                "name":"飞猪优惠",
                "type":1,
                "desc":"已减20.01"
            }
        },
        "successful":true,
        "ret_code":"012",
        "added_service_list":{
            "added_service":[
                {
                    "service_desc":"夜间取车收取的服务费用",
                    "service_quantity":"1",
                    "service_price":"30.00",
                    "is_one_way_fee":1,
                    "service_price_amount":"40.00",
                    "service_name":"夜间服务费",
                    "is_fixed":1,
                    "sid":"34"
                }
            ]
        },
        "cancel_strategy_struct":{
            "cancel_rules":{
                "cancel_rule":[
                    {
                        "num":50,
                        "time":30
                    }
                ]
            },
            "manual_check_time":0,
            "cancel_type":2,
            "support_cancel":true
        },
        "exts":"{\"key\":\"value\"}",
        "ret_msg":"orderId为空"
    }
}

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.renewaldetail.query (租车分销续租详情接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ