阿里安全开放平台-阿里聚安全

请求地址：

环境	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	KeyWordSearchRequest	可选			param
└ user_latitude String 可选 11 userLatitude └ user_longitude String 可选 11 userLongitude └ search_current_city Boolean 可选 true searchCurrentCity └ login_user_id String 可选 1 loginUserId └ version String 可选 1.0 version └ check_out_time String 可选 2021-06-10 checkOutTime └ check_in_time String 可选 2021-06-09 checkInTime └ key_word String 可选杭州 keyWord └ option Number 可选 0 option └ city_name String 可选杭州 cityName └ city_id String 可选 330100 cityId

名称	类型	示例值	描述
result	KeyWordSearchResponse	{}	KeyWordSearchResponse
└ fh_msg String fhMsg fhMsg business BaseDivisiontVo [] [] business └ search_percent String 10 搜索占比 └ user_search_percent String 30 用户搜索占比 └ type String 3 类型 province BaseVo {} 省 └ v String 330000 省名称 └ k String 浙江省省id city BaseVo {} 城市 └ v String 330100 城市名称 └ k String 杭州市城市id └ v String 西湖商圈商圈名称 └ k String 1233333 商圈id hotels HotelSimpleVo [] {} 酒店 └ city_id String 330100 城市id └ full_room Boolean false 是否满房 └ price Number 100 价格 └ address String 西湖地址 └ v String 测试酒店酒店名称 └ k String 1 酒店id city_list RecommendCityInfo [] {} 城市 └ search_percent String 1 搜索占比 └ user_search_percent String 1 用户搜索占比 └ type String 1 类型 province BaseVo 1 省 └ v String 1 省名称 └ k String 1 省id city BaseVo 1 城市 └ v String 1 城市id └ k String 1 城市名称 └ v String 1 城市名称 └ k String 1 城市id pois PoiVo [] [] pois city BaseVo {} 城市 └ v String 11 城市id └ k String 1 城市名称 └ address String 1 地址 └ longitude String 1 longitude └ latitude String 1 latitude └ v String 1 名称 province BaseVo {} 省 └ v String 1 省名称 └ k String 1 省id district BaseVo {} 行政区 └ v String 1 行政区名称 └ k String 1 行政区id other_city_areas OtherCityAreas 1 其他城市结果 business BaseDivisiontVo [] 1 商圈 └ search_percent String 1 搜索占比 └ user_search_percent String 1 用户搜索占比 └ type String 1 类型 province BaseVo 1 省 └ v String 1 省名称 └ k String 1 省id city BaseVo 1 城市 └ v String 1 城市名称 └ k String 1 城市id └ v String 1 城市名称 └ k String 1 城市id city_list RecommendCityInfo [] 1 城市 └ search_percent String 1 搜索占比 └ user_search_percent String 1 用户搜索占比 └ type String 1 类型 province BaseVo 1 省 └ v String 1 省名称 └ k String 1 省id city BaseVo 1 城市 └ v String 1 城市名称 └ k String 1 城市id └ v String 1 行政区名称 └ k String 1 行政区id pois PoiVo [] [] pois district BaseVo {} 行政区 └ v String v 行政区名称 └ k String k 行政区id province BaseVo {} 省 └ v String v 省名称 └ k String k 省id city BaseVo {} 城市 └ v String v 城市名称 └ k String k 城市id └ latitude String 1 latitude └ longitude String 1 longitude └ address String 1 POI地址 └ v String 1 POI名称 hotels HotelSimpleVo [] 1 酒店 └ city_id String 1 城市id └ full_room Boolean 1 是否满房 └ price Number 1 房价 └ address String 1 酒店地址 └ v String 测试酒店酒店名称 └ k String 1 酒店id district_list BaseDivisiontVo [] 1 行政区 └ search_percent String 11 搜索占比 └ user_search_percent String 1 用户搜索占比 └ type String 1 类型 province BaseVo 1 省 └ v String 1 省名称 └ k String 1 省id city BaseVo 1 城市 └ v String 1 城市名称 └ k String 1 城市id └ v String 1 行政区名称 └ k String 1 行政区id pois PoiVo [] 1 pois district BaseVo 1 行政区 └ v String 1 行政区名称 └ k String 1 行政区id province BaseVo 1 省 └ v String 1 省名称 └ k String 1 省id city BaseVo 1 城市 └ v String 1 城市名称 └ k String 1 城市id └ latitude String 1 latitude └ longitude String 1 longitude └ address String 1 地址 └ v String 1 Poi名称 district_list BaseDivisiontVo [] 1 行政区 └ search_percent String 1 搜索占比 └ user_search_percent String 1 用户搜索占比 └ type String 1 类型 province BaseVo 1 省 └ v String 1 省名称 └ k String 1 省id city BaseVo 1 城市 └ v String 1 城市名称 └ k String 1 城市id └ v String 1 行政区名称 └ k String 1 行政区id └ fh_code String 1 fhCode pois PoiVo [] 1 pois district BaseVo 1 行政区 └ v String 1 行政区名称 └ k String 1 行政区id province BaseVo 1 省 └ v String 1 省名称 └ k String 1 省id city BaseVo 1 城市 └ v String 1 城市名称 └ k String 1 城市id └ latitude String 1 纬度 └ longitude String 1 经度 └ address String 1 地址 └ v String 1 poi名称 └ fh_success Boolean true fhSuccess

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripFuturehotelSearchRelevanceKeywordRequest req = new AlitripFuturehotelSearchRelevanceKeywordRequest();
AlitripFuturehotelSearchRelevanceKeywordRequest.KeyWordSearchRequest obj1 = new AlitripFuturehotelSearchRelevanceKeywordRequest.KeyWordSearchRequest();
obj1.setUserLatitude("11");
obj1.setUserLongitude("11");
obj1.setSearchCurrentCity(true);
obj1.setLoginUserId("1");
obj1.setVersion("1.0");
obj1.setCheckOutTime("2021-06-10");
obj1.setCheckInTime("2021-06-09");
obj1.setKeyWord("杭州");
obj1.setOption(0L);
obj1.setCityName("杭州");
obj1.setCityId("330100");
req.setParam(obj1);
AlitripFuturehotelSearchRelevanceKeywordResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripFuturehotelSearchRelevanceKeywordRequest req = new AlitripFuturehotelSearchRelevanceKeywordRequest();
AlitripFuturehotelSearchRelevanceKeywordRequest.KeyWordSearchRequestDomain obj1 = new AlitripFuturehotelSearchRelevanceKeywordRequest.KeyWordSearchRequestDomain();
obj1.UserLatitude = "11";
obj1.UserLongitude = "11";
obj1.SearchCurrentCity = true;
obj1.LoginUserId = "1";
obj1.Version = "1.0";
obj1.CheckOutTime = "2021-06-10";
obj1.CheckInTime = "2021-06-09";
obj1.KeyWord = "杭州";
obj1.Option = 0L;
obj1.CityName = "杭州";
obj1.CityId = "330100";
req.Param_ = obj1;
AlitripFuturehotelSearchRelevanceKeywordResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripFuturehotelSearchRelevanceKeywordRequest;
$param = new KeyWordSearchRequest;
$param->user_latitude="11";
$param->user_longitude="11";
$param->search_current_city="true";
$param->login_user_id="1";
$param->version="1.0";
$param->check_out_time="2021-06-10";
$param->check_in_time="2021-06-09";
$param->key_word="杭州";
$param->option="0";
$param->city_name="杭州";
$param->city_id="330100";
$req->setParam(json_encode($param));
$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.futurehotel.search.relevance.keyword' \
-d 'partner_id=apidoc' \
-d 'sign=34FDA47382E31D6CE23A1E22C9562FF1' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-12-14+16%3A10%3A30' \
-d 'v=2.0' \
-d 'param=null'

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

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

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

XML示例
JSON示例

<alitrip_futurehotel_search_relevance_keyword_response>
    <result>
        <fh_msg>fhMsg</fh_msg>
        <business>
            <base_divisiont_vo>
                <search_percent>10</search_percent>
                <user_search_percent>30</user_search_percent>
                <type>3</type>
                <province>
                    <v>330000</v>
                    <k>浙江省</k>
                </province>
                <city>
                    <v>330100</v>
                    <k>杭州市</k>
                </city>
                <v>西湖商圈</v>
                <k>1233333</k>
            </base_divisiont_vo>
        </business>
        <hotels>
            <hotel_simple_vo>
                <city_id>330100</city_id>
                <full_room>false</full_room>
                <price>100</price>
                <address>西湖</address>
                <v>测试酒店</v>
                <k>1</k>
            </hotel_simple_vo>
        </hotels>
        <city_list>
            <recommend_city_info>
                <search_percent>1</search_percent>
                <user_search_percent>1</user_search_percent>
                <type>1</type>
                <province>
                    <v>1</v>
                    <k>1</k>
                </province>
                <city>
                    <v>1</v>
                    <k>1</k>
                </city>
                <v>1</v>
                <k>1</k>
                <pois>
                    <poi_vo>
                        <city>
                            <v>11</v>
                            <k>1</k>
                        </city>
                        <address>1</address>
                        <longitude>1</longitude>
                        <latitude>1</latitude>
                        <v>1</v>
                        <province>
                            <v>1</v>
                            <k>1</k>
                        </province>
                        <district>
                            <v>1</v>
                            <k>1</k>
                        </district>
                    </poi_vo>
                </pois>
            </recommend_city_info>
        </city_list>
        <other_city_areas>
            <business>
                <base_divisiont_vo>
                    <search_percent>1</search_percent>
                    <user_search_percent>1</user_search_percent>
                    <type>1</type>
                    <province>
                        <v>1</v>
                        <k>1</k>
                    </province>
                    <city>
                        <v>1</v>
                        <k>1</k>
                    </city>
                    <v>1</v>
                    <k>1</k>
                </base_divisiont_vo>
            </business>
            <city_list>
                <recommend_city_info>
                    <search_percent>1</search_percent>
                    <user_search_percent>1</user_search_percent>
                    <type>1</type>
                    <province>
                        <v>1</v>
                        <k>1</k>
                    </province>
                    <city>
                        <v>1</v>
                        <k>1</k>
                    </city>
                    <v>1</v>
                    <k>1</k>
                    <pois>
                        <poi_vo>
                            <district>
                                <v>v</v>
                                <k>k</k>
                            </district>
                            <province>
                                <v>v</v>
                                <k>k</k>
                            </province>
                            <city>
                                <v>v</v>
                                <k>k</k>
                            </city>
                            <latitude>1</latitude>
                            <longitude>1</longitude>
                            <address>1</address>
                            <v>1</v>
                        </poi_vo>
                    </pois>
                </recommend_city_info>
            </city_list>
            <hotels>
                <hotel_simple_vo>
                    <city_id>1</city_id>
                    <full_room>1</full_room>
                    <price>1</price>
                    <address>1</address>
                    <v>测试酒店</v>
                    <k>1</k>
                </hotel_simple_vo>
            </hotels>
            <district_list>
                <base_divisiont_vo>
                    <search_percent>11</search_percent>
                    <user_search_percent>1</user_search_percent>
                    <type>1</type>
                    <province>
                        <v>1</v>
                        <k>1</k>
                    </province>
                    <city>
                        <v>1</v>
                        <k>1</k>
                    </city>
                    <v>1</v>
                    <k>1</k>
                </base_divisiont_vo>
            </district_list>
            <pois>
                <poi_vo>
                    <district>
                        <v>1</v>
                        <k>1</k>
                    </district>
                    <province>
                        <v>1</v>
                        <k>1</k>
                    </province>
                    <city>
                        <v>1</v>
                        <k>1</k>
                    </city>
                    <latitude>1</latitude>
                    <longitude>1</longitude>
                    <address>1</address>
                    <v>1</v>
                </poi_vo>
            </pois>
        </other_city_areas>
        <district_list>
            <base_divisiont_vo>
                <search_percent>1</search_percent>
                <user_search_percent>1</user_search_percent>
                <type>1</type>
                <province>
                    <v>1</v>
                    <k>1</k>
                </province>
                <city>
                    <v>1</v>
                    <k>1</k>
                </city>
                <v>1</v>
                <k>1</k>
            </base_divisiont_vo>
        </district_list>
        <fh_code>1</fh_code>
        <pois>
            <poi_vo>
                <district>
                    <v>1</v>
                    <k>1</k>
                </district>
                <province>
                    <v>1</v>
                    <k>1</k>
                </province>
                <city>
                    <v>1</v>
                    <k>1</k>
                </city>
                <latitude>1</latitude>
                <longitude>1</longitude>
                <address>1</address>
                <v>1</v>
            </poi_vo>
        </pois>
        <fh_success>true</fh_success>
    </result>
</alitrip_futurehotel_search_relevance_keyword_response>

{
    "alitrip_futurehotel_search_relevance_keyword_response":{
        "result":{
            "fh_msg":"fhMsg",
            "business":{
                "base_divisiont_vo":[
                    {
                        "search_percent":"10",
                        "user_search_percent":"30",
                        "type":"3",
                        "province":{
                            "v":"330000",
                            "k":"浙江省"
                        },
                        "city":{
                            "v":"330100",
                            "k":"杭州市"
                        },
                        "v":"西湖商圈",
                        "k":"1233333"
                    }
                ]
            },
            "hotels":{
                "hotel_simple_vo":[
                    {
                        "city_id":"330100",
                        "full_room":false,
                        "price":100,
                        "address":"西湖",
                        "v":"测试酒店",
                        "k":"1"
                    }
                ]
            },
            "city_list":{
                "recommend_city_info":[
                    {
                        "search_percent":"1",
                        "user_search_percent":"1",
                        "type":"1",
                        "province":{
                            "v":"1",
                            "k":"1"
                        },
                        "city":{
                            "v":"1",
                            "k":"1"
                        },
                        "v":"1",
                        "k":"1",
                        "pois":{
                            "poi_vo":[
                                {
                                    "city":{
                                        "v":"11",
                                        "k":"1"
                                    },
                                    "address":"1",
                                    "longitude":"1",
                                    "latitude":"1",
                                    "v":"1",
                                    "province":{
                                        "v":"1",
                                        "k":"1"
                                    },
                                    "district":{
                                        "v":"1",
                                        "k":"1"
                                    }
                                }
                            ]
                        }
                    }
                ]
            },
            "other_city_areas":{
                "business":{
                    "base_divisiont_vo":[
                        {
                            "search_percent":"1",
                            "user_search_percent":"1",
                            "type":"1",
                            "province":{
                                "v":"1",
                                "k":"1"
                            },
                            "city":{
                                "v":"1",
                                "k":"1"
                            },
                            "v":"1",
                            "k":"1"
                        }
                    ]
                },
                "city_list":{
                    "recommend_city_info":[
                        {
                            "search_percent":"1",
                            "user_search_percent":"1",
                            "type":"1",
                            "province":{
                                "v":"1",
                                "k":"1"
                            },
                            "city":{
                                "v":"1",
                                "k":"1"
                            },
                            "v":"1",
                            "k":"1",
                            "pois":{
                                "poi_vo":[
                                    {
                                        "district":{
                                            "v":"v",
                                            "k":"k"
                                        },
                                        "province":{
                                            "v":"v",
                                            "k":"k"
                                        },
                                        "city":{
                                            "v":"v",
                                            "k":"k"
                                        },
                                        "latitude":"1",
                                        "longitude":"1",
                                        "address":"1",
                                        "v":"1"
                                    }
                                ]
                            }
                        }
                    ]
                },
                "hotels":{
                    "hotel_simple_vo":[
                        {
                            "city_id":"1",
                            "full_room":1,
                            "price":1,
                            "address":"1",
                            "v":"测试酒店",
                            "k":"1"
                        }
                    ]
                },
                "district_list":{
                    "base_divisiont_vo":[
                        {
                            "search_percent":"11",
                            "user_search_percent":"1",
                            "type":"1",
                            "province":{
                                "v":"1",
                                "k":"1"
                            },
                            "city":{
                                "v":"1",
                                "k":"1"
                            },
                            "v":"1",
                            "k":"1"
                        }
                    ]
                },
                "pois":{
                    "poi_vo":[
                        {
                            "district":{
                                "v":"1",
                                "k":"1"
                            },
                            "province":{
                                "v":"1",
                                "k":"1"
                            },
                            "city":{
                                "v":"1",
                                "k":"1"
                            },
                            "latitude":"1",
                            "longitude":"1",
                            "address":"1",
                            "v":"1"
                        }
                    ]
                }
            },
            "district_list":{
                "base_divisiont_vo":[
                    {
                        "search_percent":"1",
                        "user_search_percent":"1",
                        "type":"1",
                        "province":{
                            "v":"1",
                            "k":"1"
                        },
                        "city":{
                            "v":"1",
                            "k":"1"
                        },
                        "v":"1",
                        "k":"1"
                    }
                ]
            },
            "fh_code":"1",
            "pois":{
                "poi_vo":[
                    {
                        "district":{
                            "v":"1",
                            "k":"1"
                        },
                        "province":{
                            "v":"1",
                            "k":"1"
                        },
                        "city":{
                            "v":"1",
                            "k":"1"
                        },
                        "latitude":"1",
                        "longitude":"1",
                        "address":"1",
                        "v":"1"
                    }
                ]
            },
            "fh_success":true
        }
    }
}

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下载

飞猪-菲住联盟

alitrip.futurehotel.search.relevance.keyword (关键字搜索)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈