Skip to main content

房量查询

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

请求方式#

POST

uri: /ari/daily/inventory

Content-Type: application/json


请求参数说明#

RequestHeader#

公共请求头[引用]

RequestBody#

参数类型是否必填最大长度示例描述
hotelIdStringY3212**567华住酒店ID
startDateDateY-2021-10-01开始日期,格式 yyyy-MM-dd
endDateDateY-2021-10-02结束日期,格式 yyyy-MM-dd (查询出的库存包含这一天)
checkinTypeStringY16DAY入住类型, DAY: 全日房 HOUR: 时租房,区分大小写
productCandidatesList<ProductCandidate>N-产品信息,不传则查询酒店在开始结束日期内的全部产品库存信息

ProductCandidate#

参数类型是否必填最大长度示例描述
roomTypeCodeStringY64DR1房型Code
rateCodeStringY64Base-NTR房价码

响应参数说明#

公共响应参数[引用]

响应码-code[引用]

content#

参数类型是否必填最大长度示例描述
hotelIdStringY3212**567华住酒店ID
startDateDateY-2021-10-01开始日期,格式 yyyy-MM-dd
endDateDateY-2021-10-02结束日期,格式 yyyy-MM-dd (查询出的库存包含这一天)
dailyInventoriesList<DailyInventory>Y-库存信息

DailyInventory#

参数类型是否必填最大长度示例描述
roomTypeCodeStringY64DR1房型Code
rateCodeStringY64Base-NTR房价码
inventoriesList<Integer>Y-从startDate至endDate,包含endDate,每日剩余库存

响应码#

异常码异常类型说明
1000Success
4301Start date and end date does not match the rules开始结束日期不符合规则
4302End date is invalid结束日期无效
4303Start date is invalid开始日期无效
4304Invalid hotel Id酒店Id不存在
4305Hotel is closed酒店停业
4306No 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"}