飞猪 - 开放平台

请求地址：

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

名称	类型	是否必须	描述
feed_hotel_query	FeedHotelQuery	必须	查询条件
└ after_modified_time String 可选 2013-12-01 00:00:00 最后更新时间 └ language String 必须 cn 标准语言ISO_639-1 二字码；例如：cn,en
page_request	PageRequest	必须	分页配置
└ size Number 可选 100 分页_size └ page Number 可选 1 分页_页数

名称	类型	示例值	描述
trace_id	String	2127f0c417024824014503859e2dd2	traceId
data	PageableContent		分页结果
data Hotel [] 酒店列表 └ rooms Number 10 酒店房间数 └ position_type String GaoDe 经纬度来源，Google:谷歌地图;GaoDe:高德 └ minimum_guest_age String 1 最小入住年龄 └ latitude String 30.269311 酒店经纬度-纬度 └ description String 这是一个美丽的酒店，距离机场xxx公里酒店描述 └ remark String 酒店不提供一次性洗漱用品酒店提醒 └ city_id String 654300 城市ID └ country_id String 1 国家ID pictures FeedPicture [] 图片列表 └ id String 391391725 图片id └ url String //img.alicdn.com/imgextra/i1/6000000005240/O1CN01N8k0Ud1oZyBSnB3UV_!!6000000005240-0-hotel.jpg 图片地址 └ desc String xxx 图片描述 └ city_name String 阿勒泰地区城市名称 └ tel String ##17374899426,0086#0906#2888889 酒店联系电话 └ longitude String 119.950899 酒店经纬度-经度 └ address String 地址酒店地址 └ star String 4 星级 └ check_in_time String 12:00 checkIn时间 └ hotel_id String 55104001 酒店ID └ hotel_name String xxx酒店酒店名称 └ check_out_time String 12:00 checkout 时间 └ country_name String China 国际名称 facilities FeedFacility [] 酒店设施 └ name String 1 设施名称 └ description String xxxx 设施描述 └ id String 333519399 设施id └ status Number 0 酒店状态0:下线 ,1:上线 room_types FeedRoomType [] 房型 └ room_id String 房型id 房型id └ room_name String 房型名称房型名称 └ page_index Number 2 pageIndex └ page_size Number 10 pageSize

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelDistributionFeedHotelQueryRequest req = new XhotelDistributionFeedHotelQueryRequest();
XhotelDistributionFeedHotelQueryRequest.FeedHotelQuery obj1 = new XhotelDistributionFeedHotelQueryRequest.FeedHotelQuery();
obj1.setAfterModifiedTime("2013-12-01 00:00:00");
obj1.setLanguage("cn");
req.setFeedHotelQuery(obj1);
XhotelDistributionFeedHotelQueryRequest.PageRequest obj2 = new XhotelDistributionFeedHotelQueryRequest.PageRequest();
obj2.setSize(100L);
obj2.setPage(1L);
req.setPageRequest(obj2);
XhotelDistributionFeedHotelQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
XhotelDistributionFeedHotelQueryRequest req = new XhotelDistributionFeedHotelQueryRequest();
XhotelDistributionFeedHotelQueryRequest.FeedHotelQueryDomain obj1 = new XhotelDistributionFeedHotelQueryRequest.FeedHotelQueryDomain();
obj1.AfterModifiedTime = "2013-12-01 00:00:00";
obj1.Language = "cn";
req.FeedHotelQuery_ = obj1;
XhotelDistributionFeedHotelQueryRequest.PageRequestDomain obj2 = new XhotelDistributionFeedHotelQueryRequest.PageRequestDomain();
obj2.Size = 100L;
obj2.Page = 1L;
req.PageRequest_ = obj2;
XhotelDistributionFeedHotelQueryResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new XhotelDistributionFeedHotelQueryRequest;
$feed_hotel_query = new FeedHotelQuery;
$feed_hotel_query->after_modified_time="2013-12-01 00:00:00";
$feed_hotel_query->language="cn";
$req->setFeedHotelQuery(json_encode($feed_hotel_query));
$page_request = new PageRequest;
$page_request->size="100";
$page_request->page="1";
$req->setPageRequest(json_encode($page_request));
$resp = $c->execute($req, $sessionKey);

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=taobao.xhotel.distribution.feed.hotel.query' \
-d 'partner_id=apidoc' \
-d 'session=f9a2e4dc-d5ff-41c2-8da2-ff0ef2db97ce' \
-d 'sign=E3364C6C5F9BBC4780D4E9E17B7ED5E5' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-11-21+21%3A00%3A30' \
-d 'v=2.0' \
-d 'feed_hotel_query=null' \
-d 'page_request=null'

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

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

req.feed_hotel_query="数据结构示例JSON格式"
req.page_request="数据结构示例JSON格式"
try:
	resp= req.getResponse(sessionkey)
	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,"taobao.xhotel.distribution.feed.hotel.query");
add_param(pRequest,"feed_hotel_query","数据结构JSON示例");
add_param(pRequest,"page_request","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
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('taobao.xhotel.distribution.feed.hotel.query', {
	'feed_hotel_query':'数据结构JSON示例',
	'page_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<xhotel_distribution_feed_hotel_query_response>
    <trace_id>2127f0c417024824014503859e2dd2</trace_id>
    <data>
        <data>
            <hotel>
                <rooms>10</rooms>
                <position_type>GaoDe</position_type>
                <minimum_guest_age>1</minimum_guest_age>
                <latitude>30.269311</latitude>
                <description>这是一个美丽的酒店，距离机场xxx公里</description>
                <remark>酒店不提供一次性洗漱用品</remark>
                <city_id>654300</city_id>
                <country_id>1</country_id>
                <pictures>
                    <feed_picture>
                        <id>391391725</id>
                        <url>//img.alicdn.com/imgextra/i1/6000000005240/O1CN01N8k0Ud1oZyBSnB3UV_!!6000000005240-0-hotel.jpg</url>
                        <desc>xxx</desc>
                    </feed_picture>
                </pictures>
                <city_name>阿勒泰地区</city_name>
                <tel>##17374899426,0086#0906#2888889</tel>
                <longitude>119.950899</longitude>
                <address>地址</address>
                <star>4</star>
                <check_in_time>12:00</check_in_time>
                <hotel_id>55104001</hotel_id>
                <hotel_name>xxx酒店</hotel_name>
                <check_out_time>12:00</check_out_time>
                <country_name>China</country_name>
                <facilities>
                    <feed_facility>
                        <name>1</name>
                        <description>xxxx</description>
                        <id>333519399</id>
                    </feed_facility>
                </facilities>
                <status>0</status>
                <room_types>
                    <feed_room_type>
                        <room_id>房型id</room_id>
                        <room_name>房型名称</room_name>
                    </feed_room_type>
                </room_types>
            </hotel>
        </data>
        <page_index>2</page_index>
        <page_size>10</page_size>
    </data>
</xhotel_distribution_feed_hotel_query_response>

{
    "xhotel_distribution_feed_hotel_query_response":{
        "trace_id":"2127f0c417024824014503859e2dd2",
        "data":{
            "data":{
                "hotel":[
                    {
                        "rooms":10,
                        "position_type":"GaoDe",
                        "minimum_guest_age":"1",
                        "latitude":"30.269311",
                        "description":"这是一个美丽的酒店，距离机场xxx公里",
                        "remark":"酒店不提供一次性洗漱用品",
                        "city_id":"654300",
                        "country_id":"1",
                        "pictures":{
                            "feed_picture":[
                                {
                                    "id":"391391725",
                                    "url":"\/\/img.alicdn.com\/imgextra\/i1\/6000000005240\/O1CN01N8k0Ud1oZyBSnB3UV_!!6000000005240-0-hotel.jpg",
                                    "desc":"xxx"
                                }
                            ]
                        },
                        "city_name":"阿勒泰地区",
                        "tel":"##17374899426,0086#0906#2888889",
                        "longitude":"119.950899",
                        "address":"地址",
                        "star":"4",
                        "check_in_time":"12:00",
                        "hotel_id":"55104001",
                        "hotel_name":"xxx酒店",
                        "check_out_time":"12:00",
                        "country_name":"China",
                        "facilities":{
                            "feed_facility":[
                                {
                                    "name":"1",
                                    "description":"xxxx",
                                    "id":"333519399"
                                }
                            ]
                        },
                        "status":0,
                        "room_types":{
                            "feed_room_type":[
                                {
                                    "room_id":"房型id",
                                    "room_name":"房型名称"
                                }
                            ]
                        }
                    }
                ]
            },
            "page_index":2,
            "page_size":10
        }
    }
}

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

taobao.xhotel.distribution.feed.hotel.query (飞猪酒店分销-静态信息-酒店-查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ