房量查询
获取指定时间范围内的酒店商品房量,返回结果为数组,数组顺序与日期对应
#
请求方式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 | - | 产品信息,不传则查询酒店在开始结束日期内的全部产品库存信息 |
#
ProductCandidate参数 | 类型 | 是否必填 | 最大长度 | 示例 | 描述 |
---|---|---|---|---|---|
roomTypeCode | String | Y | 64 | DR1 | 房型Code |
rateCode | String | Y | 64 | Base-NTR | 房价码 |
#
响应参数说明#
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 | 未找到与条件匹配的数据 |
其他 | 全局异常码 | 全局异常[引用] |
#
报文示例#
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"}