淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
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。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
hotel_key	String	必须	1		酒店id
city_key	String	可选	1		城市id

名称	类型	示例值	描述
errno	String	1	错误码
data	Data		数据实体
└ region String 东城区行政区 └ city_name String 北京城市名 └ phone String 010-1122334 电话 └ region_id String 22 行政区id └ lng String 120.22223344 经度 └ name String 丽晶大宾馆酒店名称 └ room_count Number 400 房间数量 └ city_code String 11223 城市id └ area Number 23334 总面积 └ hotel_desc String 丽晶大酒店对面的丽晶大宾馆中文酒店说明 brand_data BrandData 品牌介绍 └ poi_count Number 12234 总酒店数 └ name String 香格里拉品牌名称 └ brand_id Number 1122 品牌id └ brand_desc String 巴拉巴拉品牌介绍 └ city_count Number 123 城市覆盖数 └ logo_url String http://www.baifu.com 品牌logo └ lat String 31.22333444 纬度 └ renovation_year String 2018 最近装修年份 └ construction_year String 2017 开业年份 └ business_district_name String 望京商圈 └ comments_count Number 200 总评论数 └ hotel_key String 1122334 酒店id └ fax String 010-1122233 传真 └ business_district_id String 1 商圈id free_service FreeService [] 免费服务信息 └ description String 1瓶矿泉水免费服务说明 └ amenity_key String 7095 免费服务id └ star Number 3 星级 └ credit_cards String [] 支持信用卡列表 attr_tag_list AttrTagList 酒店标签 └ internet Boolean true 是否支持上网 └ credit_card_settlement Boolean true 是否能够信用卡结算 └ front_desk_safe Boolean true 是否有前台保险柜 └ postal_service Boolean true 是否有邮政服务 └ wakeup_call Boolean true 是否有叫醒服务 └ concierge_service Boolean true 是否有礼宾服务 └ lobby_boy Boolean true 是否专职门童 └ bellboy Boolean true 是否专职行李员 └ front_desk24h Boolean true 是否24小时前台 └ luggage Boolean true 是否能行李寄存 └ meeting_room Boolean true 是否有会议室 └ swimming_pool Boolean true 是否有游泳池 └ spa Boolean true 是否有spa └ gymnasium Boolean true 是否有健身室 └ public_area_wifi Boolean true 公共区域是否有wifi └ room_wifi Boolean true 房间是否有wifi └ foreign_guest Boolean true 能否接待外宾 └ wellness Boolean true 是否有健康和美容区 └ top_quality Boolean true 是否供应商优质酒店 └ restaurant Boolean true 是否有餐厅 └ parking Boolean true 是否有停车场 └ no_smoking Boolean true 是否房间不允许吸烟 └ monitoring_system Boolean true 是否有监控系统 └ multi_function_hall Boolean true 是否有多功能厅 └ business_center Boolean true 是否有商务中心 └ food_delivery_service Boolean true 是否有送餐服务 └ coffee_shop Boolean true 是否有咖啡厅 └ western_restaurant Boolean true 是否有西餐厅 └ one_time_billing Boolean true 是否一次性账单结算 └ car_rental_service Boolean true 是否有租车服务 └ pick_up_station Boolean true 是否有接站服务 └ pick_up_plane Boolean true 是否有接机服务 └ for_laundry Boolean true 是否外送洗衣 └ avg_rating String 4.5 平均评分 └ floor Number 10 总楼层熟 └ address String 马路对面地址 └ email String leeizhang@liyun.com 邮箱 └ postal_code String 068450 邮编 distance_desc DistanceInfo [] 距离信息列表 └ desc String 距离望京地铁站100米详细说明 └ numerical String 1000 数值，单位米 └ type String city 不限于如下，city("城市中心"), trainStation("最近的车站"), airport("最近的机场"), highway("最近的高速公路"), └ type_name String 上海 type为city，type_name为上海 └ hotel_desc_en String _the ritz hotel across from the regent hotel 酒店英文介绍 └ front_img String http://img.com/112233.png 酒店头图 pic_data PicData [] 酒店图片列表 └ location String 大厅图片标签 └ picture_id String 11223 图片id └ url String http://ssds.com/img/ssj.png 图片url └ checkout_latest String HH:mm:ssZ 最晚离店时间 └ checkin_earliest String HH:mm:ssZ 最入住时间
errmsg	String	success	错误信息

{"city_key":"1","hotel_key":"1"}

{
    "errno":"1",
    "data":{
        "region":"东城区",
        "city_name":"北京",
        "phone":"010-1122334",
        "region_id":"22",
        "lng":"120.22223344",
        "name":"丽晶大宾馆",
        "room_count":400,
        "city_code":"11223",
        "area":23334,
        "hotel_desc":"丽晶大酒店对面的丽晶大宾馆",
        "brand_data":{
            "poi_count":12234,
            "name":"香格里拉",
            "brand_id":1122,
            "brand_desc":"巴拉巴拉",
            "city_count":123,
            "logo_url":"http:\/\/www.baifu.com"
        },
        "lat":"31.22333444",
        "renovation_year":"2018",
        "construction_year":"2017",
        "business_district_name":"望京",
        "comments_count":200,
        "hotel_key":"1122334",
        "fax":"010-1122233",
        "business_district_id":"1",
        "free_service":[
            {
                    "description":"1瓶矿泉水",
                    "amenity_key":"7095"
            }
        ],
        "star":3,
        "attr_tag_list":{
            "internet":true,
            "credit_card_settlement":true,
            "front_desk_safe":true,
            "postal_service":true,
            "wakeup_call":true,
            "concierge_service":true,
            "lobby_boy":true,
            "bellboy":true,
            "front_desk24h":true,
            "luggage":true,
            "meeting_room":true,
            "swimming_pool":true,
            "spa":true,
            "gymnasium":true,
            "public_area_wifi":true,
            "room_wifi":true,
            "foreign_guest":true,
            "wellness":true,
            "top_quality":true,
            "restaurant":true,
            "parking":true,
            "no_smoking":true,
            "monitoring_system":true,
            "multi_function_hall":true,
            "business_center":true,
            "food_delivery_service":true,
            "coffee_shop":true,
            "western_restaurant":true,
            "one_time_billing":true,
            "car_rental_service":true,
            "pick_up_station":true,
            "pick_up_plane":true,
            "for_laundry":true
        },
        "avg_rating":"4.5",
        "floor":10,
        "address":"马路对面",
        "email":"leeizhang@liyun.com",
        "postal_code":"068450",
        "distance_desc":[
            {
                    "desc":"距离望京地铁站100米",
                    "numerical":"1000",
                    "type":"city",
                    "type_name":"上海"
            }
        ],
        "hotel_desc_en":"_the ritz hotel across from the regent hotel",
        "front_img":"http:\/\/img.com\/112233.png",
        "pic_data":[
            {
                    "location":"大厅",
                    "picture_id":"11223",
                    "url":"http:\/\/ssds.com\/img\/ssj.png"
            }
        ],
        "checkout_latest":"HH:mm:ssZ",
        "checkin_earliest":"HH:mm:ssZ"
    },
    "errmsg":"success"
}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

欢行开发平台API

qimen.alibaba.happytrip.hotel.detail.data.get (酒店静态信息详情查询)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ