淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	描述
methodName	String	必须	qimen	方法名
hotelFutureRQ	HotelFutureRQ	可选		未来酒店对接请求RQ
└ oid Number 可选 123 OTA订单id，即第三方系统中的订单id └ ext String 可选 {"key":"value"} 特殊透传参数 └ checkOut String 可选 "" 查询房态时用到的参数,日期参数格式: yyyy-MM-dd └ checkIn String 可选 "" 查询房态时用到的参数,日期参数格式: yyyy-MM-dd └ roomTypeID String 可选 1 外部房型ID └ sourceType Number 可选 1 sourceType └ reqOutSystem Number 可选 1 请求的外部系统枚举表示(用于请求石基CIA或者智能设备) smartDeviceCtrl SmartDeviceCtrl 可选 "" 智能设备控制 └ roomNum String 可选 1212 房间号门锁控制时由对接设置 └ ctrlType String 可选 1 操作类型 faceScanInfo FaceScanInfo 可选 "" 扫脸入住信息 guestInfo GuestInfo 可选客户信息 └ guestName String 可选小红姓名 └ certificateType Number 可选 20 证件类型 └ certificateNum String 可选 33100419900321 证件号 └ nation String 可选汉族民族 └ address String 可选北京地址 └ base64Img String 可选图片编码刷脸照片 └ deviceId String 可选 1212 设备ID └ birthday String 可选 1990-02-14 生日 └ sex String 可选男性别 └ signOffice String 可选余杭公安局签发机构 └ usefulSDate String 可选 2018-10 有效起始时间 └ usefulEDate String 可选 2028-10 有效截止时间 └ message String 可选无身份证附加消息 └ country String 可选中国国家 └ province String 可选浙江省份 └ city String 可选杭州城市 └ phone String 可选 13176854561 电话 guestBill Struct 可选 "" 查询水单 └ roomNum String 可选 1231 房间号 └ shortIdNumber String 可选待定待启用 └ hotelCode String 可选 HZ01 酒店编码 checkInInfo CheckInInfo 可选 "" 自助入住信息 └ roomNum String 可选 1211 房间号 └ deviceId String 可选 11111111 设备id guestList GuestInfo [] 可选客户信息 └ guestName String 可选小红姓名 └ certificateType Number 可选 20 证件类型 └ certificateNum String 可选 33100419900321 证件号 └ nation String 可选汉族民族 └ address String 可选北京地址 └ base64Img String 可选图片编码刷脸照片 └ deviceId String 可选 122121 设备ID └ birthday String 可选 1990-02-14 生日 └ sex String 可选男性别 └ signOffice String 可选余杭公安局签发机构 └ usefulSDate String 可选 2018-10 有效起始日期 └ usefulEDate String 可选 2028-10 有效截止日期 └ message String 可选无身份证附加消息 └ country String 可选中国国家 └ province String 可选浙江省份 └ city String 可选杭州城市 └ phone String 可选 13587463721 电话 roomSelectInfo RoomSelectInfo 可选 "" 在线选房参数 └ type Number 可选 1 选房操作类型 * 1:选房操作；2: 取消选房；3: 变更选房 └ roomTypeID String 可选 1232 订单绑定外部房型ID └ buildingNum String 可选 1 楼号 └ floor String 可选 2 楼层 └ roomNum String 可选 1221 所选择房间号 └ oldRoomNum String 可选 1111 原始房间号(变更选房时候有效) checkOutInfo CheckOutInfo 可选 "" 退房信息 └ actionTime String 可选 2018-01-11 10:00:00 想要退房时间 └ needInvoice Number 可选 1 是否需要开发票 * 0:不需要开发票；1：需要开发票 invoiceInfo InvoiceInfo 可选 "" 发票信息 └ invoiceType Number 可选 1 发票类型（1:普通发票；2：增值税专用发票） └ invoiceTitle String 可选阿里巴巴发票抬头 └ taxpayerId String 可选 12353433 纳税人识别号：纳税人识别号,一律由15位、18或者20位码（字符型）组成。 └ regAddress String 可选杭州公司注册地址：抬头公司注册地址 └ companyTel String 可选 0571-88836777 公司电话：抬头公司电话，区号-电话号码 └ bankName String 可选高星支行开户行：抬头公司银行开户行名称 └ bankAccount String 可选 2343533 银行账户：抬头公司银行账号 └ postType Number 可选 1 发票领取方式（ 0：前台自取 1：邮寄 2：电子发票 3: 送至房间） └ earllyPrepare Number 可选 1 发票是否需要提前准备（目前提前开，咱不考虑此值）（0：不提前开发票 1:需要提前开好发票） └ provider Number 可选 1 邮费承担方 1：酒店承担 2：商家承担 3：去啊平台承担 4：客户自己承担 └ receiverName String 可选小王收件人姓名 └ receiverMobile String 可选 13198768763 收件人手机号 └ receiverAddress String 可选上海收件地址 └ wantTime String 可选 2018-01-11 09:00:00 需要发票时间(格式yyyy-MM-dd HH:mm:ss) └ comment String 可选无备注信息 └ attributes String 可选 {"a":1,"b":2} 特殊透传对接参数 └ displayText String 可选 XXXX 建议pms提示文案 └ pmsConfig String 可选 {"a":1,"b":2} pms配置信息 └ pmsAction Number 可选 1 pms处理消息的动作 └ vendor String 可选 taobao vendor └ sellerNick String 可选淘酒店卖家名称 └ sellerId Number 可选 122222222222 卖家ID └ hid Number 可选 121111 酒店hid └ hotelCode String 可选 hhhf-ff 外部酒店code编码 └ outOrderId String 可选 32222222222 外部订单ID └ tid Number 可选 11111111122 淘宝订单ID └ operateType Number 可选 1 操作类型 └ requestId String 可选 123122232000jjd0jf 唯一请求ID,需要在结果中返回 queryOrderInfo QueryOrderInfo 可选查询订单请求 └ guestName String 可选小红客户名称 └ certificateNum String 可选 124232 证件号，目前支持身份证 └ phone String 可选 13114533467 手机号码 └ deviceId String 可选 1223 设备号 └ appName String 可选 xxx 应用名 └ appVersion String 可选 1.1 应用版本

名称	类型	示例值	描述
result	Result		未来酒店奇门接口返回对象
└ success Boolean false 是否成功 └ errMsg String 业务错误错误信息 └ code String 1 错误码 └ responseMsg String {} 结果上下文，根据类型不同，具体联系技术支持 └ flag String failure 表示请求是否成功 └ outCode String 13 外部错误码 └ outMsg String 参数异常外部错误信息 └ processStatus Number 1 请求的处理状态

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

QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
TaobaoXhotelFuturehotelRequest req = new TaobaoXhotelFuturehotelRequest();
req.setMethodName("qimen");
TaobaoXhotelFuturehotelRequest.HotelFutureRQ obj1 = new TaobaoXhotelFuturehotelRequest.HotelFutureRQ();
obj1.setOid(123L);
obj1.setExt("{\"key\":\"value\"}");
obj1.setCheckOut("\"\"");
obj1.setCheckIn("\"\"");
obj1.setRoomTypeID("1");
obj1.setSourceType(1L);
obj1.setReqOutSystem(1L);
TaobaoXhotelFuturehotelRequest.SmartDeviceCtrl obj2 = new TaobaoXhotelFuturehotelRequest.SmartDeviceCtrl();
obj2.setRoomNum("1212");
obj2.setCtrlType("1");
obj1.setSmartDeviceCtrl(obj2);
TaobaoXhotelFuturehotelRequest.FaceScanInfo obj3 = new TaobaoXhotelFuturehotelRequest.FaceScanInfo();
TaobaoXhotelFuturehotelRequest.GuestInfo obj4 = new TaobaoXhotelFuturehotelRequest.GuestInfo();
obj4.setGuestName("小红");
obj4.setCertificateType(20L);
obj4.setCertificateNum("33100419900321");
obj4.setNation("汉族");
obj4.setAddress("北京");
obj4.setBase64Img("图片编码");
obj4.setDeviceId("1212");
obj4.setBirthday("1990-02-14");
obj4.setSex("男");
obj4.setSignOffice("余杭公安局");
obj4.setUsefulSDate("2018-10");
obj4.setUsefulEDate("2028-10");
obj4.setMessage("无");
obj4.setCountry("中国");
obj4.setProvince("浙江");
obj4.setCity("杭州");
obj4.setPhone("13176854561");
obj3.setGuestInfo(obj4);
obj1.setFaceScanInfo(obj3);
TaobaoXhotelFuturehotelRequest.Struct obj5 = new TaobaoXhotelFuturehotelRequest.Struct();
obj5.setRoomNum("1231");
obj5.setShortIdNumber("待定");
obj5.setHotelCode("HZ01");
obj1.setGuestBill(obj5);
TaobaoXhotelFuturehotelRequest.CheckInInfo obj6 = new TaobaoXhotelFuturehotelRequest.CheckInInfo();
obj6.setRoomNum("1211");
obj6.setDeviceId("11111111");
List<TaobaoXhotelFuturehotelRequest.GuestInfo> list8 = new ArrayList<TaobaoXhotelFuturehotelRequest.GuestInfo>();
TaobaoXhotelFuturehotelRequest.GuestInfo obj9 = new TaobaoXhotelFuturehotelRequest.GuestInfo();
list8.add(obj9);
obj9.setGuestName("小红");
obj9.setCertificateType(20L);
obj9.setCertificateNum("33100419900321");
obj9.setNation("汉族");
obj9.setAddress("北京");
obj9.setBase64Img("图片编码");
obj9.setDeviceId("122121");
obj9.setBirthday("1990-02-14");
obj9.setSex("男");
obj9.setSignOffice("余杭公安局");
obj9.setUsefulSDate("2018-10");
obj9.setUsefulEDate("2028-10");
obj9.setMessage("无");
obj9.setCountry("中国");
obj9.setProvince("浙江");
obj9.setCity("杭州");
obj9.setPhone("13587463721");
obj6.setGuestList(list8);
obj1.setCheckInInfo(obj6);
TaobaoXhotelFuturehotelRequest.RoomSelectInfo obj10 = new TaobaoXhotelFuturehotelRequest.RoomSelectInfo();
obj10.setType(1L);
obj10.setRoomTypeID("1232");
obj10.setBuildingNum("1");
obj10.setFloor("2");
obj10.setRoomNum("1221");
obj10.setOldRoomNum("1111");
obj1.setRoomSelectInfo(obj10);
TaobaoXhotelFuturehotelRequest.CheckOutInfo obj11 = new TaobaoXhotelFuturehotelRequest.CheckOutInfo();
obj11.setActionTime("2018-01-11 10:00:00");
obj11.setNeedInvoice(1L);
obj1.setCheckOutInfo(obj11);
TaobaoXhotelFuturehotelRequest.InvoiceInfo obj12 = new TaobaoXhotelFuturehotelRequest.InvoiceInfo();
obj12.setInvoiceType(1L);
obj12.setInvoiceTitle("阿里巴巴");
obj12.setTaxpayerId("12353433");
obj12.setRegAddress("杭州");
obj12.setCompanyTel("0571-88836777");
obj12.setBankName("高星支行");
obj12.setBankAccount("2343533");
obj12.setPostType(1L);
obj12.setEarllyPrepare(1L);
obj12.setProvider(1L);
obj12.setReceiverName("小王");
obj12.setReceiverMobile("13198768763");
obj12.setReceiverAddress("上海");
obj12.setWantTime("2018-01-11 09:00:00");
obj12.setComment("无");
obj1.setInvoiceInfo(obj12);
obj1.setAttributes("{\"a\":1,\"b\":2}");
obj1.setDisplayText("XXXX");
obj1.setPmsConfig("{\"a\":1,\"b\":2}");
obj1.setPmsAction(1L);
obj1.setVendor("taobao");
obj1.setSellerNick("淘酒店");
obj1.setSellerId(122222222222L);
obj1.setHid(121111L);
obj1.setHotelCode("hhhf-ff");
obj1.setOutOrderId("32222222222");
obj1.setTid(11111111122L);
obj1.setOperateType(1L);
obj1.setRequestId("123122232000jjd0jf");
TaobaoXhotelFuturehotelRequest.QueryOrderInfo obj13 = new TaobaoXhotelFuturehotelRequest.QueryOrderInfo();
obj13.setGuestName("小红");
obj13.setCertificateNum("124232");
obj13.setPhone("13114533467");
obj13.setDeviceId("1223");
obj13.setAppName("xxx");
obj13.setAppVersion("1.1");
obj1.setQueryOrderInfo(obj13);
req.setHotelFutureRQ(obj1);
TaobaoXhotelFuturehotelResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
TaobaoXhotelFuturehotelRequest req = new TaobaoXhotelFuturehotelRequest();
req.MethodName = "qimen";
TaobaoXhotelFuturehotelRequest.HotelFutureRQDomain obj1 = new TaobaoXhotelFuturehotelRequest.HotelFutureRQDomain();
obj1.Oid = 123L;
obj1.Ext = "{\"key\":\"value\"}";
obj1.CheckOut = "\"\"";
obj1.CheckIn = "\"\"";
obj1.RoomTypeID = "1";
obj1.SourceType = 1L;
obj1.ReqOutSystem = 1L;
TaobaoXhotelFuturehotelRequest.SmartDeviceCtrlDomain obj2 = new TaobaoXhotelFuturehotelRequest.SmartDeviceCtrlDomain();
obj2.RoomNum = "1212";
obj2.CtrlType = "1";
obj1.SmartDeviceCtrl= obj2;
TaobaoXhotelFuturehotelRequest.FaceScanInfoDomain obj3 = new TaobaoXhotelFuturehotelRequest.FaceScanInfoDomain();
TaobaoXhotelFuturehotelRequest.GuestInfoDomain obj4 = new TaobaoXhotelFuturehotelRequest.GuestInfoDomain();
obj4.GuestName = "小红";
obj4.CertificateType = 20L;
obj4.CertificateNum = "33100419900321";
obj4.Nation = "汉族";
obj4.Address = "北京";
obj4.Base64Img = "图片编码";
obj4.DeviceId = "1212";
obj4.Birthday = "1990-02-14";
obj4.Sex = "男";
obj4.SignOffice = "余杭公安局";
obj4.UsefulSDate = "2018-10";
obj4.UsefulEDate = "2028-10";
obj4.Message = "无";
obj4.Country = "中国";
obj4.Province = "浙江";
obj4.City = "杭州";
obj4.Phone = "13176854561";
obj3.GuestInfo= obj4;
obj1.FaceScanInfo= obj3;
TaobaoXhotelFuturehotelRequest.StructDomain obj5 = new TaobaoXhotelFuturehotelRequest.StructDomain();
obj5.RoomNum = "1231";
obj5.ShortIdNumber = "待定";
obj5.HotelCode = "HZ01";
obj1.GuestBill= obj5;
TaobaoXhotelFuturehotelRequest.CheckInInfoDomain obj6 = new TaobaoXhotelFuturehotelRequest.CheckInInfoDomain();
obj6.RoomNum = "1211";
obj6.DeviceId = "11111111";
List<TaobaoXhotelFuturehotelRequest.GuestInfoDomain> list8 = new List<TaobaoXhotelFuturehotelRequest.GuestInfoDomain>();
TaobaoXhotelFuturehotelRequest.GuestInfoDomain obj9 = new TaobaoXhotelFuturehotelRequest.GuestInfoDomain();
list8.Add(obj9);
obj9.GuestName = "小红";
obj9.CertificateType = 20L;
obj9.CertificateNum = "33100419900321";
obj9.Nation = "汉族";
obj9.Address = "北京";
obj9.Base64Img = "图片编码";
obj9.DeviceId = "122121";
obj9.Birthday = "1990-02-14";
obj9.Sex = "男";
obj9.SignOffice = "余杭公安局";
obj9.UsefulSDate = "2018-10";
obj9.UsefulEDate = "2028-10";
obj9.Message = "无";
obj9.Country = "中国";
obj9.Province = "浙江";
obj9.City = "杭州";
obj9.Phone = "13587463721";
obj6.GuestList= list8;
obj1.CheckInInfo= obj6;
TaobaoXhotelFuturehotelRequest.RoomSelectInfoDomain obj10 = new TaobaoXhotelFuturehotelRequest.RoomSelectInfoDomain();
obj10.Type = 1L;
obj10.RoomTypeID = "1232";
obj10.BuildingNum = "1";
obj10.Floor = "2";
obj10.RoomNum = "1221";
obj10.OldRoomNum = "1111";
obj1.RoomSelectInfo= obj10;
TaobaoXhotelFuturehotelRequest.CheckOutInfoDomain obj11 = new TaobaoXhotelFuturehotelRequest.CheckOutInfoDomain();
obj11.ActionTime = "2018-01-11 10:00:00";
obj11.NeedInvoice = 1L;
obj1.CheckOutInfo= obj11;
TaobaoXhotelFuturehotelRequest.InvoiceInfoDomain obj12 = new TaobaoXhotelFuturehotelRequest.InvoiceInfoDomain();
obj12.InvoiceType = 1L;
obj12.InvoiceTitle = "阿里巴巴";
obj12.TaxpayerId = "12353433";
obj12.RegAddress = "杭州";
obj12.CompanyTel = "0571-88836777";
obj12.BankName = "高星支行";
obj12.BankAccount = "2343533";
obj12.PostType = 1L;
obj12.EarllyPrepare = 1L;
obj12.Provider = 1L;
obj12.ReceiverName = "小王";
obj12.ReceiverMobile = "13198768763";
obj12.ReceiverAddress = "上海";
obj12.WantTime = "2018-01-11 09:00:00";
obj12.Comment = "无";
obj1.InvoiceInfo= obj12;
obj1.Attributes = "{\"a\":1,\"b\":2}";
obj1.DisplayText = "XXXX";
obj1.PmsConfig = "{\"a\":1,\"b\":2}";
obj1.PmsAction = 1L;
obj1.Vendor = "taobao";
obj1.SellerNick = "淘酒店";
obj1.SellerId = 122222222222L;
obj1.Hid = 121111L;
obj1.HotelCode = "hhhf-ff";
obj1.OutOrderId = "32222222222";
obj1.Tid = 11111111122L;
obj1.OperateType = 1L;
obj1.RequestId = "123122232000jjd0jf";
TaobaoXhotelFuturehotelRequest.QueryOrderInfoDomain obj13 = new TaobaoXhotelFuturehotelRequest.QueryOrderInfoDomain();
obj13.GuestName = "小红";
obj13.CertificateNum = "124232";
obj13.Phone = "13114533467";
obj13.DeviceId = "1223";
obj13.AppName = "xxx";
obj13.AppVersion = "1.1";
obj1.QueryOrderInfo= obj13;
req.HotelFutureRQ_ = obj1;
TaobaoXhotelFuturehotelResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new TaobaoXhotelFuturehotelRequest;
$req->setMethodName("qimen");
$hotelFutureRQ = new HotelFutureRQ;
$hotelFutureRQ->oid="123";
$hotelFutureRQ->ext="{\"key\":\"value\"}";
$hotelFutureRQ->check_out="\"\"";
$hotelFutureRQ->check_in="\"\"";
$hotelFutureRQ->room_type_i_d="1";
$hotelFutureRQ->source_type="1";
$hotelFutureRQ->req_out_system="1";
$smartDeviceCtrl = new SmartDeviceCtrl;
$smartDeviceCtrl->room_num="1212";
$smartDeviceCtrl->ctrl_type="1";
$hotelFutureRQ->smartDeviceCtrl = $smartDeviceCtrl;
$faceScanInfo = new FaceScanInfo;
$guestInfo = new GuestInfo;
$guestInfo->guest_name="小红";
$guestInfo->certificate_type="20";
$guestInfo->certificate_num="33100419900321";
$guestInfo->nation="汉族";
$guestInfo->address="北京";
$guestInfo->base64_img="图片编码";
$guestInfo->device_id="1212";
$guestInfo->birthday="1990-02-14";
$guestInfo->sex="男";
$guestInfo->sign_office="余杭公安局";
$guestInfo->useful_s_date="2018-10";
$guestInfo->useful_e_date="2028-10";
$guestInfo->message="无";
$guestInfo->country="中国";
$guestInfo->province="浙江";
$guestInfo->city="杭州";
$guestInfo->phone="13176854561";
$faceScanInfo->guestInfo = $guestInfo;
$hotelFutureRQ->faceScanInfo = $faceScanInfo;
$guestBill = new Struct;
$guestBill->room_num="1231";
$guestBill->short_id_number="待定";
$guestBill->hotel_code="HZ01";
$hotelFutureRQ->guestBill = $guestBill;
$checkInInfo = new CheckInInfo;
$checkInInfo->room_num="1211";
$checkInInfo->device_id="11111111";
$guestList = new GuestInfo;
$guestList->guest_name="小红";
$guestList->certificate_type="20";
$guestList->certificate_num="33100419900321";
$guestList->nation="汉族";
$guestList->address="北京";
$guestList->base64_img="图片编码";
$guestList->device_id="122121";
$guestList->birthday="1990-02-14";
$guestList->sex="男";
$guestList->sign_office="余杭公安局";
$guestList->useful_s_date="2018-10";
$guestList->useful_e_date="2028-10";
$guestList->message="无";
$guestList->country="中国";
$guestList->province="浙江";
$guestList->city="杭州";
$guestList->phone="13587463721";
$checkInInfo->guestList = $guestList;
$hotelFutureRQ->checkInInfo = $checkInInfo;
$roomSelectInfo = new RoomSelectInfo;
$roomSelectInfo->type="1";
$roomSelectInfo->room_type_i_d="1232";
$roomSelectInfo->building_num="1";
$roomSelectInfo->floor="2";
$roomSelectInfo->room_num="1221";
$roomSelectInfo->old_room_num="1111";
$hotelFutureRQ->roomSelectInfo = $roomSelectInfo;
$checkOutInfo = new CheckOutInfo;
$checkOutInfo->action_time="2018-01-11 10:00:00";
$checkOutInfo->need_invoice="1";
$hotelFutureRQ->checkOutInfo = $checkOutInfo;
$invoiceInfo = new InvoiceInfo;
$invoiceInfo->invoice_type="1";
$invoiceInfo->invoice_title="阿里巴巴";
$invoiceInfo->taxpayer_id="12353433";
$invoiceInfo->reg_address="杭州";
$invoiceInfo->company_tel="0571-88836777";
$invoiceInfo->bank_name="高星支行";
$invoiceInfo->bank_account="2343533";
$invoiceInfo->post_type="1";
$invoiceInfo->earlly_prepare="1";
$invoiceInfo->provider="1";
$invoiceInfo->receiver_name="小王";
$invoiceInfo->receiver_mobile="13198768763";
$invoiceInfo->receiver_address="上海";
$invoiceInfo->want_time="2018-01-11 09:00:00";
$invoiceInfo->comment="无";
$hotelFutureRQ->invoiceInfo = $invoiceInfo;
$hotelFutureRQ->attributes="{\"a\":1,\"b\":2}";
$hotelFutureRQ->display_text="XXXX";
$hotelFutureRQ->pms_config="{\"a\":1,\"b\":2}";
$hotelFutureRQ->pms_action="1";
$hotelFutureRQ->vendor="taobao";
$hotelFutureRQ->seller_nick="淘酒店";
$hotelFutureRQ->seller_id="122222222222";
$hotelFutureRQ->hid="121111";
$hotelFutureRQ->hotel_code="hhhf-ff";
$hotelFutureRQ->out_order_id="32222222222";
$hotelFutureRQ->tid="11111111122";
$hotelFutureRQ->operate_type="1";
$hotelFutureRQ->request_id="123122232000jjd0jf";
$queryOrderInfo = new QueryOrderInfo;
$queryOrderInfo->guest_name="小红";
$queryOrderInfo->certificate_num="124232";
$queryOrderInfo->phone="13114533467";
$queryOrderInfo->device_id="1223";
$queryOrderInfo->app_name="xxx";
$queryOrderInfo->app_version="1.1";
$hotelFutureRQ->queryOrderInfo = $queryOrderInfo;
$req->setHotelFutureRQ(json_encode($hotelFutureRQ));
$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=qimen.taobao.xhotel.futurehotel' \
-d 'partner_id=apidoc' \
-d 'sign=6269734E7F90BD80DE81DC218C1B1D70' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-19+13%3A44%3A04' \
-d 'v=2.0' \
-d 'hotelFutureRQ=null' \
-d 'methodName=qimen'

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

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

req.methodName="qimen"
req.hotelFutureRQ="数据结构示例JSON格式"
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,"qimen.taobao.xhotel.futurehotel");
add_param(pRequest,"methodName","qimen");
add_param(pRequest,"hotelFutureRQ","数据结构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('qimen.taobao.xhotel.futurehotel', {
	'methodName':'qimen',
	'hotelFutureRQ':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<result>
    <success>false</success>
    <errMsg>业务错误</errMsg>
    <code>1</code>
    <responseMsg>{}</responseMsg>
    <flag>failure</flag>
    <outCode>13</outCode>
    <outMsg>参数异常</outMsg>
    <processStatus>1</processStatus>
</result>

{
    "result":{
        "success":false,
        "errMsg":"业务错误",
        "code":"1",
        "responseMsg":"{}",
        "flag":"failure",
        "outCode":"13",
        "outMsg":"参数异常",
        "processStatus":1
    }
}

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

qimen.taobao.xhotel.futurehotel (云上hfc提供的标准未来酒店接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ