获取白名单列表-帮助中心 - 小象代理 - 优质高速HTTP代理IP-爬虫-代理服务器

获取白名单列表

更新时间： 2023-09-13 14:46:17

[TOC]

### 1. 接口描述

- 获取应用已经绑定的白名单列表。

### 2. 调用频率

- 1次/秒

### 3. 请求URL

- `https://api.xiaoxiangdaili.com/app/getBindIpList`

### 4. 请求方式

- GET

### 5. 请求参数说明

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
| appKey |  <font style="color:#dd0000;">是</font> |  应用账号 | 产品管理页面查看 |
| appSecret |  <font style="color:#dd0000;">是</font> |  应用密钥 | 产品管理页面查看 |
| proxy |  否 |  代理IP地址 | 格式为ip:port，静态代理必须输入参数，其他类型产品该参数无效 |

说明：仅静态代理产品的白名单与代理服务器绑定，因此需要传proxy参数；其他产品的白名单都是与应用账号绑定，与服务器无关。

### 6. 调用示例

```rust
GET https://api.xiaoxiangdaili.com/app/getBindIpList?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
```

### 7. 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": {
        "limit": 5,
		"bindIpList": ["119.45.11.12"],
		"count": 1
    },
    "msg": "操作成功"
}
```

### 8. 返回参数说明

#### 8.1 公共参数说明
|参数名|类型|说明|
|:-----  |:-----|-----  |
| code | int   | 状态码  |
| success | bool | 是否成功 |
| data | object | 返回业务参数 |
| msg | string | 信息 |

#### 8.2 业务参数说明（data）

|参数名|类型|说明|
|:-----  |:-----|-----                           |
| limit | int  | 白名单最大数量 |
| count | int  | 已经绑定的白名单数量 |
| bindIpList | array(string) | 白名单IP 列表 |

### 9. 状态码code说明
| code值 | 描述 |
|:-----  |:-----|
| 200 | 成功 |
| 1001 | 应用不存在 |
| 1002 | 应用已被冻结或禁用 |
| 1003 | 应用已过期 |
| 1005 | 应用不存在或已过期 |
| 1006 | 应用授权验证未通过 |
| 1012 | 产品类型不匹配 |
| 1018 | 代理池不匹配 |
| 1019 | 当前代理IP无效 |
| 2000 | 未知异常 |

上一篇：绑定白名单