可购地区列表查询
查询可购买地区IP数量
接口信息
GET /client/ip/pool/regionalAvailableIps
请求头
| 参数名 | 类型 | 描述 |
|---|---|---|
| x-merchant-token | String | 商户令牌 |
| x-merchant-code | String | 商户代码 |
请求参数
| 参数名 | 必选 | 类型 | 描述 |
|---|---|---|---|
| type | 否 | Integer | IP类别 0广播 1原生 |
| ipCategory | 否 | String | IP属性 IDC机房 HOST住宅 |
| continents | 否 | Array[String] | 州列表 |
| countryCodes | 否 | Array[String] | 国家代码列表 |
| locations | 否 | Array[String] | 省/区列表 |
| bandwidth | 否 | Integer | 带宽规格（Mbps），如 5、10；不传时每个可购地区可能返回多条记录，分别对应不同带宽规格 |
代码示例
/client/ip/pool/regionalAvailableIps
响应示例
{
"total": 3,
"rows": [
{
"id": 19,
"type": 1,
"ipCategory": "HOST",
"continent": "asia",
"countryCode": "hk",
"location": "hongkong",
"bandwidth": 10,
"price": 30.0000,
"price7": null,
"ipTotals": 100
},
{
"id": 19,
"type": 1,
"ipCategory": "HOST",
"continent": "asia",
"countryCode": "hk",
"location": "hongkong",
"bandwidth": 5,
"price": 20.0000,
"price7": null,
"ipTotals": 413
},
{
"id": 24,
"type": 1,
"ipCategory": "HOST",
"continent": "north_america",
"countryCode": "us",
"location": "newyork",
"bandwidth": 5,
"price": 18.0000,
"price7": null,
"ipTotals": 200
}
],
"code": 200,
"msg": "查询成功"
}
同一地区 id 可能出现多条记录，以 bandwidth 区分不同带宽规格；price、ipTotals 均为该带宽规格下的单价与可购数量。
响应参数说明
| 参数名 | 类型 | 描述 |
|---|---|---|
| id | Integer | 地区标识，与下单时的国家/地区组合对应 |
| type | Integer | IP类别：0-广播, 1-原生 |
| ipCategory | String | IP属性：HOST-住宅, IDC-机房 |
| continent | String | 大洲 |
| countryCode | String | 国家代码 |
| location | String | 省/区位置 |
| bandwidth | Integer | 带宽规格（Mbps），如 5、10 |
| price | double | 该带宽规格下的月单价（元） |
| price7 | double | 该带宽规格下的 7 天单价（元）；无 7 天售价时为 null |
| ipTotals | Integer | 该带宽规格下的可购数量 |