文档中心 > API类目 > 酒店商品API

taobao.xhotel.distribution.ari.availability (飞猪酒店分销-ARI-availability)

飞猪酒店分销-ARI-availability

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
availability_query AvailabilityQuery 必须 查询条件
  • └ check_in
  • String
  • 必须
  • 2023-01-01
  • yyyy-MM-dd
  • └ children
  • Number
  • 可选
  • 0
  • 儿童人数
  • └ adults
  • Number
  • 必须
  • 2
  • 成人人数
  • └ language
  • String
  • 必须
  • cn
  • 标准语言ISO_639-1 二字码;例如:cn,en
  • └ hotel_id
  • String
  • 必须
  • 654300
  • 酒店ID
  • └ check_out
  • String
  • 必须
  • 2023-01-02
  • yyyy-MM-dd
  • └ children_ages
  • String []
  • 可选
  • [1]
  • 每个儿童年龄,数组个数与儿童数相同

响应参数

名称 类型 示例值 描述
trace_id String 0bbb10bf17025337270113592eb09f traceId
data Ari data
  • └ language
  • String
  • en
  • 标准语言ISO_639-1 二字码;例如:cn,en
  • └ time
  • Number
  • 1702533728719
  • 13位时间戳
  • properties
  • HotelRate []
  • 价库-酒店价格列表
  • rates
  • AriRate []
  • 价库-酒店下Rate列表
  • └ rate_key
  • String
  • 10183372001007-8650196001007-2040412339007-55104001-717746504680
  • rateKey
  • cancel_policy
  • AriCancellationPolicy
  • 取消政策
  • └ code
  • String
  • 1
  • code
  • └ cancellation_desc
  • String
  • xxx
  • 取消政策描述
  • rules
  • DateDetailRule []
  • 取消规则明细
  • └ onward
  • String
  • 2023-12-14 14:02:07
  • 政策开始时间
  • └ before
  • String
  • 2023-12-15 00:00:00
  • 政策截止时间
  • └ inclusive_amount
  • String
  • 0
  • 取消政策-含税费罚金(单位:分)
  • └ currency
  • String
  • CNY
  • 币种
  • └ check_in_time
  • String
  • 14:00
  • checkInTime
  • └ remark
  • String
  • xxxx
  • 入住提醒
  • └ room_id
  • String
  • 87301001
  • 房型ID
  • └ room_name
  • String
  • 城景双床房
  • 房型名称
  • total_rate
  • AriRateTotalRate
  • 总价
  • └ inclusive
  • String
  • 2000
  • 含税费金额(单位:分)
  • └ fees
  • String
  • 0
  • 费用金额(单位:分)
  • └ exclusive
  • String
  • 2000
  • 不包含税费金额(单位:分)
  • └ tax
  • String
  • 0
  • 税费金额(单位:分)
  • └ currency
  • String
  • CNY
  • 币种
  • └ check_in
  • String
  • 2023-12-14
  • checkIn
  • └ check_out_time
  • String
  • 12:00
  • checkOutTime
  • └ rate_plan_name
  • String
  • 20230804183409829测试rp
  • RPName
  • └ check_out
  • String
  • 2023-12-15
  • checkOut
  • daily_rates
  • AriRateDailyRate []
  • 日历价
  • └ date
  • String
  • 2023-12-14
  • 日期
  • └ inclusive
  • String
  • 1000
  • 含税费金额(单位:分)
  • └ fees
  • String
  • 0
  • 费用金额(单位:分)
  • └ exclusive
  • String
  • 1000
  • 不包含税费金额(单位:分)
  • └ tax
  • String
  • 0
  • 税费金额(单位:分)
  • └ currency
  • String
  • CNY
  • 币种
  • meals
  • AriMealDTO
  • 餐食信息
  • └ number
  • Number
  • 2
  • 参数分数
  • └ type
  • Number
  • 1
  • 餐食类型 0:无餐,1:含早餐,2:含两餐,3:含三餐
  • └ hotel_id
  • String
  • 55104001
  • 酒店ID
  • └ hotel_name
  • String
  • xxxx
  • 酒店名称

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelDistributionAriAvailabilityRequest req = new XhotelDistributionAriAvailabilityRequest();
XhotelDistributionAriAvailabilityRequest.AvailabilityQuery obj1 = new XhotelDistributionAriAvailabilityRequest.AvailabilityQuery();
obj1.setCheckIn("2023-01-01");
obj1.setChildren(0L);
obj1.setAdults(2L);
obj1.setLanguage("cn");
obj1.setHotelId("654300");
obj1.setCheckOut("2023-01-02");
obj1.setChildrenAges("1");
req.setAvailabilityQuery(obj1);
XhotelDistributionAriAvailabilityResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_distribution_ari_availability_response>
    <trace_id>0bbb10bf17025337270113592eb09f</trace_id>
    <data>
        <language>en</language>
        <time>1702533728719</time>
        <properties>
            <hotel_rate>
                <rates>
                    <ari_rate>
                        <rate_key>10183372001007-8650196001007-2040412339007-55104001-717746504680</rate_key>
                        <cancel_policy>
                            <code>1</code>
                            <cancellation_desc>xxx</cancellation_desc>
                            <rules>
                                <date_detail_rule>
                                    <onward>2023-12-14 14:02:07</onward>
                                    <before>2023-12-15 00:00:00</before>
                                    <inclusive_amount>0</inclusive_amount>
                                    <currency>CNY</currency>
                                </date_detail_rule>
                            </rules>
                        </cancel_policy>
                        <check_in_time>14:00</check_in_time>
                        <remark>xxxx</remark>
                        <room_id>87301001</room_id>
                        <room_name>城景双床房</room_name>
                        <total_rate>
                            <inclusive>2000</inclusive>
                            <fees>0</fees>
                            <exclusive>2000</exclusive>
                            <tax>0</tax>
                            <currency>CNY</currency>
                        </total_rate>
                        <check_in>2023-12-14</check_in>
                        <check_out_time>12:00</check_out_time>
                        <rate_plan_name>20230804183409829测试rp</rate_plan_name>
                        <check_out>2023-12-15</check_out>
                        <daily_rates>
                            <ari_rate_daily_rate>
                                <date>2023-12-14</date>
                                <inclusive>1000</inclusive>
                                <fees>0</fees>
                                <exclusive>1000</exclusive>
                                <tax>0</tax>
                                <currency>CNY</currency>
                            </ari_rate_daily_rate>
                        </daily_rates>
                        <meals>
                            <number>2</number>
                            <type>1</type>
                        </meals>
                    </ari_rate>
                </rates>
                <hotel_id>55104001</hotel_id>
                <hotel_name>xxxx</hotel_name>
            </hotel_rate>
        </properties>
    </data>
</xhotel_distribution_ari_availability_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部