淘宝开放平台 - 文档中心

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
orderer	Orderer	必须			预定联系人信息
└ first_name String 必须 San 预定人名 └ email String 必须 leeizhang@aliyun.com 预定人邮箱 └ last_name String 必须 Zhang 预定人姓 └ mobile String 必须 18500230255 电话 └ full_name String 可选张三预定人全名 └ title String 必须 Mr. 称呼前缀 Mr.，Ms.
checkin	String	必须	2018-11-11		入住日期
offer_id	String	必须	1000		房间售卖最小单元id，可以是房屋id，也可以是售卖计划id
hotel_key	String	必须	1122334		酒店id
id_type	String	必须	smkdmksmdksnkjdnakjndka		酒店预定下单唯一标识，用于下单幂等
offer_detail	String	可选	{.*}		酒店下单附加信息，可以是房屋信息数据的JSON格式
reservation_mode	String	必须	guaranteed		担保类型：standard：标准(无担保), guaranteed：个人担保, guaranteed_by_company：企业担保
reservation_client_info	ReservationClientInfo	可选			企业垫付附属信息，非企业垫付可空
└ client String 可选 ssd 客户端识别码 └ allow_over_budget_amount String 可选 1 允许超出预算的最大金额 └ corporation_code String 可选 2232 企业合作码 └ client_name String 可选 hrs 客户端名称 └ notfication_method String 可选 sms 通知方式 sms：短信
room_type	String	必须	pair		标准房型 single：单床，pair：双床，doubles：双床+
checkout	String	必须	2018-11-15		离店日期
payment_type	String	必须	direct		支付类型：direct：前台现付, on_credit_card：信用卡支付, on_company_account：企业支付,on_external_company_account：其他企业代付, on_virtual_credit_card：虚拟信用卡支付，on_e_t_p_account：八商山支付，prepay: 预付
bed_type	String	必须	regular_bed		床型：regular_bed：常规床型, extra_bed：额外加床, parents_bed：家庭床型, child_extra_bed：儿童床
currency	String	必须	CNY		币种
reservation_wish	String	可选	有窗		预定附加信息，用户的特殊要求等
room_count	Number	必须	1		几间房
room_occupant	RoomOccupant []	必须		最大列表长度：999	房间入住人信息
person_info PersonInfo [] 必须入住人列表 └ mobile String 可选 18500230256 联系人电话 └ last_name String 必须 zhang 联系人姓 └ email String 可选 san@zhang.com 联系人邮箱 └ first_name String 必须 san 联系人名 └ full_name String 可选张三联系人全名
corp_info	String	可选	1		企业信息
biz_type	String	可选	TA		TA：因公；PRI：因私
credit_card_sign	String	可选	xxxx		信用卡加密信息,解析会得到{ "card_holder":"持卡人", "organisation":"卡类型", "valid":"mm/yy", "number":"卡号", "cvv_code":"cvv" }
loyalty_id	String	可选	123456		会员卡号

名称	类型	示例值	描述
errno	String	1	错误码
data	Data		信息实体
hotel_reservation_room_offer_detail HotelReservationRoomOfferDetail 预定详情 └ offer_id String assd223 房间售卖最小单元id，可以是房屋id，也可以是售卖计划id └ cancellation_fee_percent String 10 取消时需支付比例 └ breakfast_price String 15 早餐价格 └ rate_plan_name String 连住3天特惠售卖计划名称 └ room_type_name String 双床房房型名称 └ currency String cny 币种 └ credit_card_security_code_required Boolean true 是否需要信用卡安全码 rate Rate [] 每日价格 └ room_price_hotel String 300 价格 └ date String 2018-11-10 日期 └ exclusive_rate Boolean false 是否独家价格 └ cancelable Boolean true 能否取消 └ must_guarantee_if_etp Boolean false 如果企业垫付是否必须担保 └ credit_card_reservation_only Boolean true 是否只支持信用卡预定 └ hot_deal Boolean false 是否热卖 └ room_type_desc String 标准间: 标准双人房, 双床1.1米、2-5楼、20平米、免费宽带、可入住2人房型说明 └ guaranteed_reservation_only Boolean true 是否需要担保 └ cancellation_deadline String 2018-11-10 18:00:00 最晚取消时间 └ rate_plan_id String 122dffc 售卖计划id └ room_type_id String 112233a 房型id └ breakfast_type String inclusive 早餐类型：exclusive：不含早, unknown：未知, not_available：不支持, variant：可变的, inclusive：含早, inclusive_half_board：单早，inclusive_half_board：单早，inclusive_double_board: 双早 └ high_season Boolean false 是否旺季 └ guarantee_rule String 在18.11.08至18.11.20入住需要您提供信用卡担保。客人入住日12:00点前可以变更取消，之后无法变更取消，如未入住，将扣除第一晚房费作为违约金。担保规则说明 └ calculative_breakfast_price_hotel String 210 含早价格 └ average_room_price_hotel String 200 平均房价 └ 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: 预付 └ hotel_key String ssdd1 酒店id └ id_type String c8faa322d53848f192f93f57faf73b20 酒店预定下单唯一标识，用于下单幂等 └ order_id String ali2223345 订单id或者processKey
errmsg	String	success	错误信息

{"bed_type":"regular_bed","room_count":1,"biz_type":"TA","corp_info":"1","loyalty_id":"123456","offer_id":"1000","hotel_key":"1122334","reservation_client_info":{"corporation_code":"2232","client":"ssd","notfication_method":"sms","allow_over_budget_amount":"1","client_name":"hrs"},"reservation_mode":"guaranteed","reservation_wish":"有窗","payment_type":"direct","room_occupant":[{"person_info":[{"full_name":"张三","mobile":"18500230256","last_name":"zhang","first_name":"san","email":"san@zhang.com"}]}],"checkin":"2018-11-11","credit_card_sign":"xxxx","orderer":{"full_name":"张三","mobile":"18500230255","last_name":"Zhang","title":"Mr.","first_name":"San","email":"leeizhang@aliyun.com"},"id_type":"smkdmksmdksnkjdnakjndka","currency":"CNY","offer_detail":"{.*}","checkout":"2018-11-15","room_type":"pair"}

{
    "errno":"1",
    "data":{
        "hotel_reservation_room_offer_detail":{
            "offer_id":"assd223",
            "cancellation_fee_percent":"10",
            "breakfast_price":"15",
            "rate_plan_name":"连住3天特惠",
            "room_type_name":"双床房",
            "currency":"cny",
            "credit_card_security_code_required":true,
            "rate":[
                {
                        "room_price_hotel":"300",
                        "date":"2018-11-10"
                }
            ],
            "exclusive_rate":false,
            "cancelable":true,
            "must_guarantee_if_etp":false,
            "credit_card_reservation_only":true,
            "hot_deal":false,
            "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",
            "average_room_price_hotel":"200",
            "adult_count":2,
            "payment_type":"direct"
        },
        "hotel_key":"ssdd1",
        "id_type":"c8faa322d53848f192f93f57faf73b20",
        "order_id":"ali2223345"
    },
    "errmsg":"success"
}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

欢行开发平台API

qimen.alibaba.happytrip.hotel.booking (酒店预定)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ