淘宝开放平台 - 文档中心

请求地址：

环境	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
checkin	String	必须	2018-11-11	入住日期，酒店所在地当地时间
checkout	String	必须	2018-11-12	离店日期，酒店所在地当地时间
adult_count	Number	必须	2	入住人数
currency	String	必须	CNY	币种
room_count	Number	必须	2	总共几间房
biz_type	String	可选	因公还是因私	TA：因公；PRI：因私，因私情况下adult_count不能体现人数
corp_info	String	可选	1	企业code

名称	类型	示例值	描述
errno	Number	1	错误码
data	Data		数据实体
└ checkin String 2018-11-10 入住日期，酒店所在地当地时间 └ hotel_key String 1122334 酒店id └ hotel_name String 丽晶大宾馆酒店名称 └ checkout String 2018-11-15 离店日期，酒店所在地当地时间 room_offer_details RoomOfferDetails [] 房型报价信息 └ offer_id String assd223 售卖单元最小纬度id，可以是房型id，也可以是售卖计划id └ cancellation_fee_percent String 10.0 取消时需支付百分比 └ breakfast_price String 15.0 早餐价格 └ rate_plan_name String 连住3天特惠售卖计划名称 └ room_type_name String 双床房房型名称 └ currency String cny 币种 └ room_status String canbooking 房态： canbooking：可订；partially：部分可订；notavailable：不可订；full：满房 └ credit_card_security_code_required Boolean true 是否需要信用卡安全码 rate Rate [] 每日报价 └ room_status String canbooking 房态 canbooking：可订；notavailable：不可订 └ room_price_hotel String 300.0 含税单价 └ date String 2018-11-10 日期，酒店所在地当地时间 └ agreement_price_tag Boolean true 协议价标签 └ exclusive_rate Boolean false 是否独家价格 └ cancelable Boolean true 能否取消 └ must_guarantee_if_etp Boolean false 如果企业垫付是否必须担保 └ credit_card_reservation_only Boolean true 是否只支持信用卡预定 └ hot_deal Boolean false 是否热卖 └ offer_detail String {JSON} 预定附加信息，可以是售卖单元数据的JSON └ room_type_desc String 标准间: 标准双人房, 双床1.1米、2-5楼、20平米、免费宽带、可入住2人房型说明 └ guaranteed_reservation_only Boolean true 否需要担保 └ cancellation_deadline String 2018-11-10 18:00:00 最晚取消时间，yyyy-MM-dd HH:mm:ssZ格式 └ rate_plan_id String 122dffc 售卖计划id └ room_type_id String 112233a 房型id └ breakfast_type String inclusive inclusive：含早；exclusive：不含早, unknown：未知, not_available：无早 variant_single：费用除了早餐以外可能包含其它附加服务，比如某些娱乐项目， variant_double：费用除了早餐以外可能包含其它附加服务，比如某些娱乐项目， inclusive_single：单早， inclusive_double: 双早， inclusive_half_board_single：费用包含早餐晚餐 inclusive_half_board_double：费用包含早餐晚餐 inclusive_full_board_single：费用包含早餐中餐晚餐 inclusive_full_board_double：费用包含早餐中餐晚餐 all_Inclusive_single：费用包含全天所有用餐费用 - 早餐中餐晚餐和软饮 all_Inclusive_double：费用包含全天所有用餐费用 - 早餐中餐晚餐和软饮 └ high_season Boolean false 是否旺季 └ guarantee_rule String 在18.11.08至18.11.20入住需要您提供信用卡担保。客人入住日12:00点前可以变更取消，之后无法变更取消，如未入住，将扣除第一晚房费作为违约金。担保规则说明 └ calculative_breakfast_price_hotel String 210.0 含早价格 └ average_room_price_hotel String 200.0 平均含税价格 └ adult_count Number 2 最多可入住人数 └ payment_type String direct 支付类型：direct：前台现付, on_credit_card：信用卡支付, on_company_account：企业支付,on_external_company_account：其他企业代付, on_virtual_credit_card：虚拟信用卡支付，on_etp_account：八商山支付，prepay: 预付 no_show_fee NoShowFee noshow时收取的费用 └ type String day 费用类型，day：按间夜；precent：百分比；fee：费用金额 └ numerical String 1 数量或者金额或者百分比 └ amount String 200.00 结果金额 └ cancellation_policy String yyyy-MM-dd前不可取消取消规则 └ crs_type String hrs offer来源 └ agreement_price_tag Boolean true 是否是协议价格 └ media_id String 11223 房型图片id └ media_url String http://hello.world 房型图片地址 taxes_and_fees TaxAndFeeDetails 10:00 税费和服务费明细 └ tax_and_fee_type String vat 类型，vat：增值税；serviceTax：服务费 └ inclusive Boolean true 是否包含在房费中 └ amount_total String 10.00 金额 └ currency String CNY 币种 └ total_amount String 100.00 总价 └ must_cvv_code Boolean true 必须cvv才能下单 └ payment_type_list String [] 支付类型列表，支付类型：direct：前台现付, on_credit_card：信用卡支付, on_company_account：企业支付,on_external_company_account：其他企业代付, on_virtual_credit_card：虚拟信用卡支付，on_etp_account：八商山支付，prepay: 预付 └ rate_label String 9点前可取消售卖说明 └ prepay_rate Boolean true 是否是预付offer
errmsg	String	success	错误信息

{"checkin":"2018-11-11","room_count":2,"biz_type":"因公还是因私","corp_info":"1","currency":"CNY","checkout":"2018-11-12","hotel_key":"1","adult_count":2}

{
    "errno":1,
    "data":{
        "checkin":"2018-11-10",
        "hotel_key":"1122334",
        "hotel_name":"丽晶大宾馆",
        "checkout":"2018-11-15",
        "room_offer_details":[
            {
                    "offer_id":"assd223",
                    "cancellation_fee_percent":"10.0",
                    "breakfast_price":"15.0",
                    "rate_plan_name":"连住3天特惠",
                    "room_type_name":"双床房",
                    "currency":"cny",
                    "room_status":"canbooking",
                    "credit_card_security_code_required":true,
                    "rate":[
                        {
                                "room_status":"canbooking",
                                "room_price_hotel":"300.0",
                                "date":"2018-11-10",
                                "agreement_price_tag":true
                        }
                    ],
                    "exclusive_rate":false,
                    "cancelable":true,
                    "must_guarantee_if_etp":false,
                    "credit_card_reservation_only":true,
                    "hot_deal":false,
                    "offer_detail":"{JSON}",
                    "room_type_desc":"标准间: 标准双人房, 双床1.1米、2-5楼、20平米、免费宽带、可入住2人",
                    "guaranteed_reservation_only":true,
                    "cancellation_deadline":"2018-11-10 18:00:00",
                    "rate_plan_id":"122dffc",
                    "room_type_id":"112233a",
                    "breakfast_type":"inclusive",
                    "high_season":false,
                    "guarantee_rule":"在18.11.08至18.11.20入住需要您提供信用卡担保。客人入住日12:00点前可以变更取消，之后无法变更取消，如未入住，将扣除第一晚房费作为违约金。",
                    "calculative_breakfast_price_hotel":"210.0",
                    "average_room_price_hotel":"200.0",
                    "adult_count":2,
                    "payment_type":"direct",
                    "no_show_fee":{
                        "type":"day",
                        "numerical":"1",
                        "amount":"200.00"
                    },
                    "cancellation_policy":"yyyy-MM-dd前不可取消",
                    "crs_type":"hrs",
                    "agreement_price_tag":true,
                    "media_id":"11223",
                    "media_url":"http:\/\/hello.world",
                    "taxes_and_fees":{
                        "tax_and_fee_type":"vat",
                        "inclusive":true,
                        "amount_total":"10.00",
                        "currency":"CNY"
                    },
                    "total_amount":"100.00",
                    "must_cvv_code":true,
                    "rate_label":"9点前可取消",
                    "prepay_rate":true
            }
        ]
    },
    "errmsg":"success"
}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

欢行开发平台API

qimen.alibaba.happytrip.hotel.detail.price.get (酒店房型报价查询)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ