淘宝开放平台

请求地址：

环境	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_booking_confirm_order_request	BookingConfirmOrderRequest	可选			确认参数对象
└ bind_booking_flag Boolean 可选 false 是否合并购卡 └ brand_id Number 可选 123 品牌id └ buyer_id Number 可选 123 用户id └ channel Number 可选 123 渠道 └ checkin_date String 可选 123 入住时间 └ checkout_date String 可选 123 离店时间 └ group_id Number 可选 123 集团id └ hotel_id Number 可选 123 酒店id └ product_id Number 可选 123 商品id └ rate_id Number 可选 123 房价id └ return_fei_zhu_amount_flag Boolean 可选 false 是否返还菲住金 └ room_id Number 可选 123 房型id └ room_number Number 可选 123 房间数 └ trace_id String 可选 123 跟踪id └ use_fei_zhu_amount Boolean 可选 false 是否使用菲住金

名称	类型	示例值	描述
confirm_order_v_o	ConfirmOrderVo	123	返回对象详情
activity_discount_infos DiscountInfoDto [] [] 折扣信息 └ benefit_type Number 123 权益类型 └ discount_name String 123 折扣 └ discount_price Number 123 折扣金额 └ marketing_benefit_id Number 123 权益id └ marketing_tag String 123 权益标识 └ activity_discount_price Number 123 折扣金额 └ activity_discount_total_price Number 123 折扣总金额 └ activity_name String 123 活动名称 └ adress String 123 地址 └ cancel_policy String 123 取消政策 └ day_price_info String 123 日历价格 └ discount Number 123 折扣 └ discount_name String 123 折扣名称 └ hotel_id Number 123 酒店id └ hotel_name String 123 酒店名称 └ inventory Number 1 库存 └ latitude Number 123 纬度 └ longitude Number 123 经度 └ marketing_benefit_id Number 123 权益id └ marketing_tag String 123 权益标识 └ max_book_room_number Number 123 最大间夜 member_card_list MemberCard [] 123 卡列表 └ brand_card_id Number 123 卡id └ card_validity Number 123 会员卡有效期 └ fliggy_card_id Number 123 菲住卡id └ member_card_type Number 123 辅营卡类型 └ product_desc String 123 商品描述 └ product_id Number 123 商品id └ product_name String 123 商品名称 └ product_type Number 123 商品类型 └ promotion_amt String 123 优惠金额 └ sell_price Number 123 售价 └ member_card_price Number 123 会员卡价格 member_discount_info DiscountInfoDto 123 会员折扣信息 └ benefit_type Number 123 权益类型 └ discount_name String 123 折扣 └ discount_price Number 123 折扣金额 └ marketing_benefit_id Number 123 权益标识id └ marketing_tag String 123 权益标识 └ occupancy Number 123 可入住人数 └ occupant_info_list String [] 123 信息列表 └ org_cancel_policy String 123 原始取消政策 └ payment Number 123 支付金额 └ promotionamt Number 123 优惠金额 └ return_fei_zhu_amount Number 123 返还霏住金 └ room_name String 123 酒店名称 └ rp_name String 123 房价计划名称 └ total_room_price Number 123 总价 └ use_feizhu_points Number 123 飞猪金 └ vip_member Boolean false 是否vip └ vip_name String 123 会员等级名称
fh_code	String	123	返回码
fh_msg	String	123	返回码描述
fh_success	Boolean	123	成功标识

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripFuturehotelHaorderRoomConfirmorderRequest req = new AlitripFuturehotelHaorderRoomConfirmorderRequest();
AlitripFuturehotelHaorderRoomConfirmorderRequest.BookingConfirmOrderRequest obj1 = new AlitripFuturehotelHaorderRoomConfirmorderRequest.BookingConfirmOrderRequest();
obj1.setBindBookingFlag(false);
obj1.setBrandId(123L);
obj1.setBuyerId(123L);
obj1.setChannel(123L);
obj1.setCheckinDate("123");
obj1.setCheckoutDate("123");
obj1.setGroupId(123L);
obj1.setHotelId(123L);
obj1.setProductId(123L);
obj1.setRateId(123L);
obj1.setReturnFeiZhuAmountFlag(false);
obj1.setRoomId(123L);
obj1.setRoomNumber(123L);
obj1.setTraceId("123");
obj1.setUseFeiZhuAmount(false);
req.setParamBookingConfirmOrderRequest(obj1);
AlitripFuturehotelHaorderRoomConfirmorderResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlitripFuturehotelHaorderRoomConfirmorderRequest req = new AlitripFuturehotelHaorderRoomConfirmorderRequest();
AlitripFuturehotelHaorderRoomConfirmorderRequest.BookingConfirmOrderRequestDomain obj1 = new AlitripFuturehotelHaorderRoomConfirmorderRequest.BookingConfirmOrderRequestDomain();
obj1.BindBookingFlag = false;
obj1.BrandId = 123L;
obj1.BuyerId = 123L;
obj1.Channel = 123L;
obj1.CheckinDate = "123";
obj1.CheckoutDate = "123";
obj1.GroupId = 123L;
obj1.HotelId = 123L;
obj1.ProductId = 123L;
obj1.RateId = 123L;
obj1.ReturnFeiZhuAmountFlag = false;
obj1.RoomId = 123L;
obj1.RoomNumber = 123L;
obj1.TraceId = "123";
obj1.UseFeiZhuAmount = false;
req.ParamBookingConfirmOrderRequest_ = obj1;
AlitripFuturehotelHaorderRoomConfirmorderResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlitripFuturehotelHaorderRoomConfirmorderRequest;
$param_booking_confirm_order_request = new BookingConfirmOrderRequest;
$param_booking_confirm_order_request->bind_booking_flag="false";
$param_booking_confirm_order_request->brand_id="123";
$param_booking_confirm_order_request->buyer_id="123";
$param_booking_confirm_order_request->channel="123";
$param_booking_confirm_order_request->checkin_date="123";
$param_booking_confirm_order_request->checkout_date="123";
$param_booking_confirm_order_request->group_id="123";
$param_booking_confirm_order_request->hotel_id="123";
$param_booking_confirm_order_request->product_id="123";
$param_booking_confirm_order_request->rate_id="123";
$param_booking_confirm_order_request->return_fei_zhu_amount_flag="false";
$param_booking_confirm_order_request->room_id="123";
$param_booking_confirm_order_request->room_number="123";
$param_booking_confirm_order_request->trace_id="123";
$param_booking_confirm_order_request->use_fei_zhu_amount="false";
$req->setParamBookingConfirmOrderRequest(json_encode($param_booking_confirm_order_request));
$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.haorder.room.confirmorder' \
-d 'partner_id=apidoc' \
-d 'sign=8575DB3640942301DBC67665DB6969FF' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-07-05+18%3A47%3A16' \
-d 'v=2.0' \
-d 'param_booking_confirm_order_request=null'

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

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

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

XML示例
JSON示例

<alitrip_futurehotel_haorder_room_confirmorder_response>
    <confirm_order_v_o>
        <activity_discount_infos>
            <discount_info_dto>
                <benefit_type>123</benefit_type>
                <discount_name>123</discount_name>
                <discount_price>123</discount_price>
                <marketing_benefit_id>123</marketing_benefit_id>
                <marketing_tag>123</marketing_tag>
            </discount_info_dto>
        </activity_discount_infos>
        <activity_discount_price>123</activity_discount_price>
        <activity_discount_total_price>123</activity_discount_total_price>
        <activity_name>123</activity_name>
        <adress>123</adress>
        <cancel_policy>123</cancel_policy>
        <day_price_info>123</day_price_info>
        <discount>123</discount>
        <discount_name>123</discount_name>
        <hotel_id>123</hotel_id>
        <hotel_name>123</hotel_name>
        <inventory>1</inventory>
        <latitude>123</latitude>
        <longitude>123</longitude>
        <marketing_benefit_id>123</marketing_benefit_id>
        <marketing_tag>123</marketing_tag>
        <max_book_room_number>123</max_book_room_number>
        <member_card_list>
            <member_card>
                <brand_card_id>123</brand_card_id>
                <card_validity>123</card_validity>
                <fliggy_card_id>123</fliggy_card_id>
                <member_card_type>123</member_card_type>
                <product_desc>123</product_desc>
                <product_id>123</product_id>
                <product_name>123</product_name>
                <product_type>123</product_type>
                <promotion_amt>123</promotion_amt>
                <sell_price>123</sell_price>
            </member_card>
        </member_card_list>
        <member_card_price>123</member_card_price>
        <member_discount_info>
            <benefit_type>123</benefit_type>
            <discount_name>123</discount_name>
            <discount_price>123</discount_price>
            <marketing_benefit_id>123</marketing_benefit_id>
            <marketing_tag>123</marketing_tag>
        </member_discount_info>
        <occupancy>123</occupancy>
        <occupant_info_list>
            <string>123</string>
        </occupant_info_list>
        <org_cancel_policy>123</org_cancel_policy>
        <payment>123</payment>
        <promotionamt>123</promotionamt>
        <return_fei_zhu_amount>123</return_fei_zhu_amount>
        <room_name>123</room_name>
        <rp_name>123</rp_name>
        <total_room_price>123</total_room_price>
        <use_feizhu_points>123</use_feizhu_points>
        <vip_member>false</vip_member>
        <vip_name>123</vip_name>
    </confirm_order_v_o>
    <fh_code>123</fh_code>
    <fh_msg>123</fh_msg>
    <fh_success>123</fh_success>
</alitrip_futurehotel_haorder_room_confirmorder_response>

{
    "alitrip_futurehotel_haorder_room_confirmorder_response":{
        "confirm_order_v_o":{
            "activity_discount_infos":{
                "discount_info_dto":[
                    {
                        "benefit_type":123,
                        "discount_name":"123",
                        "discount_price":123,
                        "marketing_benefit_id":123,
                        "marketing_tag":"123"
                    }
                ]
            },
            "activity_discount_price":123,
            "activity_discount_total_price":123,
            "activity_name":"123",
            "adress":"123",
            "cancel_policy":"123",
            "day_price_info":"123",
            "discount":123,
            "discount_name":"123",
            "hotel_id":123,
            "hotel_name":"123",
            "inventory":1,
            "latitude":123,
            "longitude":123,
            "marketing_benefit_id":123,
            "marketing_tag":"123",
            "max_book_room_number":123,
            "member_card_list":{
                "member_card":[
                    {
                        "brand_card_id":123,
                        "card_validity":123,
                        "fliggy_card_id":123,
                        "member_card_type":123,
                        "product_desc":"123",
                        "product_id":123,
                        "product_name":"123",
                        "product_type":123,
                        "promotion_amt":"123",
                        "sell_price":123
                    }
                ]
            },
            "member_card_price":123,
            "member_discount_info":{
                "benefit_type":123,
                "discount_name":"123",
                "discount_price":123,
                "marketing_benefit_id":123,
                "marketing_tag":"123"
            },
            "occupancy":123,
            "occupant_info_list":{
                "string":[
                    "123"
                ]
            },
            "org_cancel_policy":"123",
            "payment":123,
            "promotionamt":123,
            "return_fei_zhu_amount":123,
            "room_name":"123",
            "rp_name":"123",
            "total_room_price":123,
            "use_feizhu_points":123,
            "vip_member":false,
            "vip_name":"123"
        },
        "fh_code":"123",
        "fh_msg":"123",
        "fh_success":123
    }
}

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.haorder.room.confirmorder (商家订单确认有房)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ