淘宝开放平台 - 文档中心

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
param_hotel_detail_r_q	HotelDetailRq	可选			详情报价入参
└ check_in String 必须 2021-06-06 入住时间 └ check_out String 必须 2021-06-06 离店时间 └ city_code Number 可选 654300 城市code └ shid Number 必须 60405003 标准ID └ sub_channel String 必须 distribution_hkfghnmiujhgv01 子渠道ID

名称	类型	示例值	描述
result	HisvResult		详情报价回参
module HotelDetailRs 详情报价回参 └ check_in Date 2021-06-06 00:00:00 入住时间 └ check_out Date 2021-06-06 00:00:00 离店时间 └ eagle_trace_id String abcdef123 跟踪ID，可忽略 rooms HotelDetailRoomDto [] 房型列表 └ area String 20 面积 └ bed_type_string String 双人床床型 └ facility String 设施设施 └ floor String 1 楼层 └ max_occupancy Number 2 最大入住人数 └ name String 大床房房间名称 └ network_service String 0 宽带服务，"0","有线上网(免费),"1","有线上网(无)","2","有线上网(收费)","3","有线上网(部分有且免费)","4","有线上网(部分有且收费)" └ pics String img//... 图片 rates HotelDetailRateDto [] 详情报价列表 └ breakfast String 双早早餐描述 └ cancel_policy_desc String 免费取消免费取消政策描述 └ company_aassist String 1 协议价，1表示协议支付 └ currency_code String CNY 币种 └ end_time_daily String 3.21 每日截止时间，可忽略 └ instant_confirm Boolean true 是否即时确认，可忽略 └ inventory_price String {"price":46943,"quota":10} 库存价格 └ item_id Number abc 商品id └ min_adv_hours Number 0 最小提前小时数，可忽略 └ min_days Number 0 最小间隔天数，可忽略 └ nod Number 0 间隔天数。可忽略 └ nop Number 0 人数 └ payment_type Number 1 支付方式，1-全额支付 └ promotion_info String [] 营销信息 └ rate_id Number 3909860467401 报价ID └ rate_plan_name String 阿里商旅专营价报价名称 └ rp_id Number 3259284392401 rpId └ start_time_daily String 1234 每日开始时间。可忽略 └ supplier_code String fliggy 供应商标识码 └ supplier_name String 飞猪供应商名称 └ support_special_invoice Boolean true 是否支持专票 btrip_hotel_cancel_policy_d_t_o BtripHotelCancelPolicyDto 取消政策 └ cancel_policy_type Number 1 取消类型 btrip_hotel_cancel_policy_info_d_t_o_list BtripHotelCancelPolicyInfoDto [] 详细的取消规则 └ hour Number 6 提前小时 └ value Number 100 罚金 └ daily_price_format_yuan Number 100 取整后每日均价 └ daily_price_view Number 100 界面展示价格 price_plan DiscountDailyPrice [] 每日优惠后价格DTO └ rate_start_time String 2000-01-01 价格计划日期 └ discount_daily_price Number 1000 不取整的每日优惠后价格 └ rounding_after_discount_daily_price Number 1000 取整的每日优惠后价格 └ srid Number 73261624 房型ID └ status Number 0 状态，状态0:正常;-1:删除 └ window_type String 1 窗型 └ search_id String 123 跟踪ID。可忽略 └ shid Number 60405003 酒店标准ID └ result_code Number 200 返回状态码 └ result_msg String 系统异常返回异常描述

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBtripHotelDistributionSearchDetailRequest req = new AlitripBtripHotelDistributionSearchDetailRequest();
AlitripBtripHotelDistributionSearchDetailRequest.HotelDetailRq obj1 = new AlitripBtripHotelDistributionSearchDetailRequest.HotelDetailRq();
obj1.setCheckIn("2021-06-06");
obj1.setCheckOut("2021-06-06");
obj1.setCityCode(654300L);
obj1.setShid(60405003L);
obj1.setSubChannel("distribution_hkfghnmiujhgv01");
req.setParamHotelDetailRQ(obj1);
AlitripBtripHotelDistributionSearchDetailResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripBtripHotelDistributionSearchDetailRequest req = new AlitripBtripHotelDistributionSearchDetailRequest();
AlitripBtripHotelDistributionSearchDetailRequest.HotelDetailRqDomain obj1 = new AlitripBtripHotelDistributionSearchDetailRequest.HotelDetailRqDomain();
obj1.CheckIn = "2021-06-06";
obj1.CheckOut = "2021-06-06";
obj1.CityCode = 654300L;
obj1.Shid = 60405003L;
obj1.SubChannel = "distribution_hkfghnmiujhgv01";
req.ParamHotelDetailRQ_ = obj1;
AlitripBtripHotelDistributionSearchDetailResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripBtripHotelDistributionSearchDetailRequest;
$param_hotel_detail_r_q = new HotelDetailRq;
$param_hotel_detail_r_q->check_in="2021-06-06";
$param_hotel_detail_r_q->check_out="2021-06-06";
$param_hotel_detail_r_q->city_code="654300";
$param_hotel_detail_r_q->shid="60405003";
$param_hotel_detail_r_q->sub_channel="distribution_hkfghnmiujhgv01";
$req->setParamHotelDetailRQ(json_encode($param_hotel_detail_r_q));
$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.btrip.hotel.distribution.search.detail' \
-d 'partner_id=apidoc' \
-d 'sign=DFAAE2DBF20DD765F05CD6133CBC8703' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-10-31+23%3A32%3A32' \
-d 'v=2.0' \
-d 'param_hotel_detail_r_q=null'

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

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

req.param_hotel_detail_r_q=""
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.btrip.hotel.distribution.search.detail");
add_param(pRequest,"param_hotel_detail_r_q","数据结构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.btrip.hotel.distribution.search.detail', {
	'param_hotel_detail_r_q':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alitrip_btrip_hotel_distribution_search_detail_response>
    <result>
        <module>
            <check_in>2021-06-06 00:00:00</check_in>
            <check_out>2021-06-06 00:00:00</check_out>
            <eagle_trace_id>abcdef123</eagle_trace_id>
            <rooms>
                <hotel_detail_room_dto>
                    <area>20</area>
                    <bed_type_string>双人床</bed_type_string>
                    <facility>设施</facility>
                    <floor>1</floor>
                    <max_occupancy>2</max_occupancy>
                    <name>大床房</name>
                    <network_service>0</network_service>
                    <pics>img//...</pics>
                    <rates>
                        <hotel_detail_rate_dto>
                            <breakfast>双早</breakfast>
                            <cancel_policy_desc>免费取消</cancel_policy_desc>
                            <company_aassist>1</company_aassist>
                            <currency_code>CNY</currency_code>
                            <end_time_daily>3.21</end_time_daily>
                            <instant_confirm>true</instant_confirm>
                            <inventory_price>{&quot;price&quot;:46943,&quot;quota&quot;:10}</inventory_price>
                            <item_id>abc</item_id>
                            <min_adv_hours>0</min_adv_hours>
                            <min_days>0</min_days>
                            <nod>0</nod>
                            <nop>0</nop>
                            <payment_type>1</payment_type>
                            <promotion_info>[]</promotion_info>
                            <rate_id>3909860467401</rate_id>
                            <rate_plan_name>阿里商旅专营价</rate_plan_name>
                            <rp_id>3259284392401</rp_id>
                            <start_time_daily>1234</start_time_daily>
                            <supplier_code>fliggy</supplier_code>
                            <supplier_name>飞猪</supplier_name>
                            <support_special_invoice>true</support_special_invoice>
                            <btrip_hotel_cancel_policy_d_t_o>
                                <cancel_policy_type>1</cancel_policy_type>
                                <btrip_hotel_cancel_policy_info_d_t_o_list>
                                    <btrip_hotel_cancel_policy_info_dto>
                                        <hour>6</hour>
                                        <value>100</value>
                                    </btrip_hotel_cancel_policy_info_dto>
                                </btrip_hotel_cancel_policy_info_d_t_o_list>
                            </btrip_hotel_cancel_policy_d_t_o>
                            <daily_price_format_yuan>100</daily_price_format_yuan>
                            <daily_price_view>100</daily_price_view>
                            <price_plan>
                                <discount_daily_price>
                                    <rate_start_time>2000-01-01</rate_start_time>
                                    <discount_daily_price>1000</discount_daily_price>
                                    <rounding_after_discount_daily_price>1000</rounding_after_discount_daily_price>
                                </discount_daily_price>
                            </price_plan>
                        </hotel_detail_rate_dto>
                    </rates>
                    <srid>73261624</srid>
                    <status>0</status>
                    <window_type>1</window_type>
                </hotel_detail_room_dto>
            </rooms>
            <search_id>123</search_id>
            <shid>60405003</shid>
        </module>
        <result_code>200</result_code>
        <result_msg>系统异常</result_msg>
    </result>
</alitrip_btrip_hotel_distribution_search_detail_response>

{
    "alitrip_btrip_hotel_distribution_search_detail_response":{
        "result":{
            "module":{
                "check_in":"2021-06-06 00:00:00",
                "check_out":"2021-06-06 00:00:00",
                "eagle_trace_id":"abcdef123",
                "rooms":{
                    "hotel_detail_room_dto":[
                        {
                            "area":"20",
                            "bed_type_string":"双人床",
                            "facility":"设施",
                            "floor":"1",
                            "max_occupancy":2,
                            "name":"大床房",
                            "network_service":"0",
                            "pics":"img\/\/...",
                            "rates":{
                                "hotel_detail_rate_dto":[
                                    {
                                        "breakfast":"双早",
                                        "cancel_policy_desc":"免费取消",
                                        "company_aassist":"1",
                                        "currency_code":"CNY",
                                        "end_time_daily":"3.21",
                                        "instant_confirm":true,
                                        "inventory_price":"{\"price\":46943,\"quota\":10}",
                                        "item_id":abc,
                                        "min_adv_hours":0,
                                        "min_days":0,
                                        "nod":0,
                                        "nop":0,
                                        "payment_type":1,
                                        "promotion_info":"[]",
                                        "rate_id":3909860467401,
                                        "rate_plan_name":"阿里商旅专营价",
                                        "rp_id":3259284392401,
                                        "start_time_daily":"1234",
                                        "supplier_code":"fliggy",
                                        "supplier_name":"飞猪",
                                        "support_special_invoice":true,
                                        "btrip_hotel_cancel_policy_d_t_o":{
                                            "cancel_policy_type":1,
                                            "btrip_hotel_cancel_policy_info_d_t_o_list":{
                                                "btrip_hotel_cancel_policy_info_dto":[
                                                    {
                                                        "hour":6,
                                                        "value":100
                                                    }
                                                ]
                                            }
                                        },
                                        "daily_price_format_yuan":100,
                                        "daily_price_view":100,
                                        "price_plan":{
                                            "discount_daily_price":[
                                                {
                                                    "rate_start_time":"2000-01-01",
                                                    "discount_daily_price":1000,
                                                    "rounding_after_discount_daily_price":1000
                                                }
                                            ]
                                        }
                                    }
                                ]
                            },
                            "srid":73261624,
                            "status":0,
                            "window_type":"1"
                        }
                    ]
                },
                "search_id":"123",
                "shid":60405003
            },
            "result_code":200,
            "result_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.btrip.hotel.distribution.search.detail (商旅酒店api分销-详情报价接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ