2.2.2.3 获取供应商国家码下所有的酒店
约 447 字大约 1 分钟
2025-11-03
注意
- 必须
- Klook通过此接口获取供应商在特定国家代码下的所有酒店ID列表
- 相同的国家码最多调用上限1000次
- Klook将根据
2.2.1.5 线下提供及固定配置数据说明中的静态数据支持的国家 code进行遍历调用
URL
接入方自行定义并提供给klook
入参
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
countryCode | String | false | 标准国家二字码 1：请参考3.4 基础数据说明2：如果酒店数量不多时,接入方和klook侧商量可以不用根据国家code拉取,则countryCode为空 |
requestToken | String | false | 供应商自定义请求token参数，1: 用于分页2: 首次请求传入为空,最大长度128 |
Base 入参扩展字段
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
supplierAccount | String | false | openApi 供应商账号数据 接入方自行定义账号数据1:账号是为了处理供应商不同账号下资源露出不同的问题,支持多账号2:若接入方无多账号，则传值为null3:长度不超过128字符串 |
入参示例
示例
{
"base": {
"requestId": "xxxx",
"requestTime": "xxx",
"requestAgent": "xxx",
"openApiSign": "xx",
"supplierAccount": "accountXX",
"version": "xxx"
},
"requestData": {
"countryCode": "HK",
"requestToken": "{\"nextPageSize\":10,\"lastRecordId\": xxx}"
}
}出参
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
hotelIdList | List<String> | true | 接入方酒店 ID 列表 |
nextRequestToken | String | false | 下次请求需要带入的 token1: 用于分页,如果没有下一次请求，则返回为空 |
出参示例
{
"success": true,
"error": {
"code": "",
"message": ""
},
"result": {
"hotelIdList": [
"10001",
"10002"
],
"nextRequestToken": "{\"nextPageSize\":11,\"lastRecordId\": xxx}"
}
}