可購地區列表查詢
查詢可購買地區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,
"ipTotals": 100
},
{
"id": 19,
"type": 1,
"ipCategory": "HOST",
"continent": "asia",
"countryCode": "hk",
"location": "hongkong",
"bandwidth": 5,
"price": 20.0000,
"ipTotals": 413
},
{
"id": 24,
"type": 1,
"ipCategory": "HOST",
"continent": "north_america",
"countryCode": "us",
"location": "newyork",
"bandwidth": 5,
"price": 18.0000,
"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 | 該帶寬規格下的月單價（元） |
| ipTotals | Integer | 該帶寬規格下的可購數量 |