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

查询代理IP状态

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

[TOC]

### 1. 接口描述

- 查询代理IP的当前使用状态信息。
- 适用产品：代理IP（长效版）

### 2. 调用频率

- 1次/秒

### 3. 请求URL

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

### 4. 请求方式

- GET

### 5. 请求参数说明

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
| appKey | 是 | 应用账号 | 产品管理页面查看 |
| appSecret | 是 | 应用密钥 | 产品管理页面查看 |
| proxy | 是 | 待查询的代理 | 格式为 {ip}:{port} |

### 6. 调用示例

```rust
GET https://api.xiaoxiangdaili.com/ip/checkState?
		appKey=950649340031422464
		&appSecret=q4adDKPC
		&proxy=1.2.3.4:5555
```

### 7. 返回示例
```json
{
    "code": 200,
    "success": true,
    "data": {
		"state": 1,
		"lockTime": "2020-01-01 00:00:00",
		"releaseTime": "2020-01-02 00:00:00",
		"releaseType": 0
	},
    "msg": "操作成功"
}
```

### 8. 返回参数说明

#### 8.1 公共参数说明

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

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

|参数名|类型|说明|
|:-----  |:-----|-----                           |
| state | int   | 当前状态：1 使用中，2 已释放  |
| lockTime | string | 开始使用时间  |
| releaseTime | string | 释放时间 |
| releaseType | int | 释放类型：0 主动释放，1 服务器自动释放 |

### 9. 状态码code说明

| code值 | 描述 |
|:-----  |:-----|
| 200 | 成功 |
| 1001 | 应用不存在 |
| 1002 | 应用已被冻结或禁用 |
| 1003 | 应用已过期 |
| 1005 | 应用不存在或已过期 |
| 1006 | 应用授权验证未通过 |
| 1201 | 参数格式错误 |
| 2000 | 未知异常 |

上一篇：查询使用中的代理IP