查询使用中的代理IP-帮助中心 - 小象代理 - 优质高速HTTP代理IP-爬虫-代理服务器

查询使用中的代理IP

更新时间： 2023-09-12 16:16:13

[TOC]

### 1. 接口描述

- 获取应用当前使用的代理IP。
- 适用产品：代理IP（长效版）

### 2. 调用频率

- 1次/秒

### 3. 请求URL

- `https://api.xiaoxiangdaili.com/ip/lockedList`

### 4. 请求方式

- GET

### 5. 请求参数说明

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
| appKey |  <font style="color:#dd0000;">是</font> |  应用账号 | 产品管理页面查看 |
| appSecret |  <font style="color:#dd0000;">是</font> |  应用密钥 | 产品管理页面查看 |

### 6. 调用示例

```rust
GET https://api.xiaoxiangdaili.com/ip/lockedList?
		appKey=950649340031422464
		&appSecret=q4adDKPC
```

### 7. 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": [
        {
            "identify": "123456",
			"state": 1,
            "lockTime": "2023-01-01 09:52:04",
            "releaseTime": "2023-01-01 20:48:04",
            "proxy": "127.0.0.1:8080"
        }
	],
    "msg": "操作成功"
}
```

### 8. 返回参数说明

#### 8.1 公共参数说明

|参数名|类型|说明|
|:-----  |:-----|-----  |
| code | int   | 状态码  |
| success | bool | 是否成功 |
| data | object | 返回业务参数，array(Object)， 代理IP信息列表 |
| msg | string | 代理 |

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

|参数名|类型|说明|
|:-----  |:-----|-----                           |
| identify | string   | 应用账号 |
| state | int   | 当前状态：1 使用中，2 已释放  |
| lockTime | string | 开始使用时间  |
| releaseTime | string | 释放时间 |
| proxy | string | ip |

### 9. 状态码code说明

| code值 | 描述 |
|:-----  |:-----|
| 200 | 成功 |
| 1001 | 应用不存在 |
| 1002 | 应用已被冻结或禁用 |
| 1003 | 应用已过期 |
| 1004 | 连接池无响应 |
| 1005 | 应用不存在或已过期 |
| 1006 | 应用授权验证未通过 |
| 1012 | 产品类型不匹配 |
| 2000 | 未知异常 |

上一篇：释放代理IP

下一篇：查询代理IP状态