房量查询

获取指定时间范围内的酒店商品房量，返回结果为数组，数组顺序与日期对应

请求方式#

POST

uri: /ari/daily/inventory

Content-Type: application/json

请求参数说明#

RequestHeader#

公共请求头[引用]

RequestBody#

参数	类型	是否必填	最大长度	示例	描述
hotelId	String	Y	32	12**567	华住酒店ID
startDate	Date	Y	-	2021-10-01	开始日期，格式 yyyy-MM-dd
endDate	Date	Y	-	2021-10-02	结束日期，格式 yyyy-MM-dd (查询出的库存包含这一天)
checkinType	String	Y	16	DAY	入住类型， DAY: 全日房 HOUR: 时租房，区分大小写
productCandidates	List<ProductCandidate>	N	-		产品信息，不传则查询酒店在开始结束日期内的全部产品库存信息
echoToken	String	N	64	7550f7497b2d4dd9beea83cd2fe8cd74	信号量通知标识，如果是收到华住信号量通知同步库存，需要带上通知的唯一标识

ProductCandidate#

参数	类型	是否必填	最大长度	示例	描述
roomTypeCode	String	Y	64	DR1	房型Code
rateCode	String	Y	64	Base-NTR	房价码

响应参数说明#

公共响应参数[引用]

响应码-code[引用]

content#

参数	类型	是否必填	最大长度	示例	描述
hotelId	String	Y	32	12**567	华住酒店ID
startDate	Date	Y	-	2021-10-01	开始日期，格式 yyyy-MM-dd
endDate	Date	Y	-	2021-10-02	结束日期，格式 yyyy-MM-dd (查询出的库存包含这一天)
dailyInventories	List<DailyInventory>	Y	-		库存信息

DailyInventory#

参数	类型	是否必填	最大长度	示例	描述
roomTypeCode	String	Y	64	DR1	房型Code
rateCode	String	Y	64	Base-NTR	房价码
inventories	List<Integer>	Y	-		从startDate至endDate，包含endDate，每日剩余库存

响应码#

异常码	异常类型	说明
1000	Success
4301	Start date and end date does not match the rules	开始结束日期不符合规则
4302	End date is invalid	结束日期无效
4303	Start date is invalid	开始日期无效
4304	Invalid hotel Id	酒店Id不存在
4305	Hotel is closed	酒店停业
4306	No match found	未找到与条件匹配的数据
4307	Unexpected results of querying room quantity	查询房量非预期结果
其他	全局异常码	全局异常[引用]

报文示例#

Case1: 查询酒店下库存#

请求示例#

{
    "hotelId":"12**567",
    "startDate":"2021-10-06",
    "endDate":"2021-10-07",
    "checkinType":"DAY"
}

响应成功示例#

{
    "code":1000,
    "content":{
        "hotelId":"12**567",
        "startDate":"2021-10-06",
        "endDate":"2021-10-07",
        "dailyInventories":[
            {
                "rateCode":"Base-NTR",
                "roomTypeCode":"ERX1",
                "inventories":[
                    0,
                    2
                ]
            },
            {
                "rateCode":"Base-PTF",
                "roomTypeCode":"ERX2",
                "inventories":[
                    0,
                    1
                ]
            }
        ]
    }
}

响应失败示例#

{
    "code":4306,
    "message":"No match found"
}

Case2 查询酒店下库存#

请求示例#

{
    "startDate":"2021-10-06",
    "endDate":"2021-10-07",
    "hotelId":"12**567",
    "checkinType":"DAY",
    "productCandidates":[
        {
            "roomTypeCode":"K1B",
            "rateCode":"Base-ODC401"
        }
    ]
}

响应成功示例#

{
    "code":1000,
    "content":{
        "hotelId":"12**567",
        "startDate":"2021-10-06",
        "endDate":"2021-10-07",
        "dailyInventories":[
            {
                "inventories":[
                    0,
                    1
                ],
                 "roomTypeCode":"K1B",
                 "rateCode":"Base-ODC401"
            }
        ]
    }
}

响应失败示例#

{
    "code":4306,
    "message":"No match found"
}