> For the complete documentation index, see [llms.txt](https://docs.ipwo.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ipwo.net/gu-zhang-pai-chu/api-fan-hui-wei-kong.md).

# API 返回为空

如果在通过 API 获取代理时，接口返回为空、无数据或没有返回可用 IP，通常表示当前请求条件未匹配到可用代理，或 API 配置存在异常。

👉 大多数情况下并不是 API 故障，可通过调整参数或检查白名单解决。

***

### 🔍 常见表现

出现以下情况时，通常属于 API 返回为空：

* API 无返回内容
* 返回空白
* 返回为空数组 `[]`
* 返回结果中没有代理 IP
* 程序获取不到代理信息

***

### ⚡ 快速检查（推荐）

请优先确认：

* API 地址是否正确
* 已配置 IP 白名单
* 请求参数是否正确
* 当前套餐是否有效

***

### 🛠 常见原因与解决方法

***

#### 1️⃣ 未配置 [IP 白名单](/huo-qu-yu-pei-zhi-dai-li/ip-bai-ming-dan.md)

API 提取方式需要配置白名单。

如果当前服务器 IP 未加入白名单：

👉 API 可能无法正常返回数据。

***

#### 解决方法

进入：

```
用户中心 → IP 白名单
```

添加当前服务器公网 IP。

***

#### 如何查看服务器 IP？

可访问：

```
https://ipinfo.io
```

查看当前公网 IP。

***

#### 2️⃣ 请求参数设置过于严格

如果设置了：

* 指定国家
* 指定城市
* 特定运营商
* 特定 session

可能导致当前无可用 IP。

***

#### 建议：

先使用最基础参数测试。

***

#### 示例（推荐）

```
仅指定国家
```

避免一开始添加过多限制条件。

***

#### 3️⃣ 当前地区暂无可用资源

部分国家 / 城市：

* 在线 IP 较少
* 当前资源不足

可能导致 API 返回为空。

***

#### 建议：

* 更换国家
* 移除城市限制
* 稍后重试

***

#### 4️⃣ API 地址错误

请确认：

* API 地址完整
* 参数拼写正确
* 未遗漏必要参数

***

#### 建议：

直接复制控制台生成的 API 地址。

***

#### 5️⃣ 当前套餐不可用

请检查：

* 套餐是否已到期
* 流量是否已用完
* 账号状态是否正常

***

#### 查看位置

```
用户中心 → 产品管理
```

***

#### 6️⃣ 请求频率过高

短时间大量请求 API：

可能导致：

* 返回变慢
* 返回为空
* 请求失败

***

#### 建议：

* 降低请求频率
* 增加请求间隔

***

### ⚙️ 程序获取为空怎么办？

如果程序中返回为空：

#### 建议检查：

* 是否正确解析 API 返回内容
* 是否存在网络超时
* 是否被代码过滤掉结果

***

#### 建议先浏览器直接访问 API 测试

👉 确认 API 本身是否正常返回。

***

### 💡 使用建议

* 推荐先使用默认参数测试
* 不建议一开始限制过多条件
* 建议优先测试国家级 IP

***

### ❗ 常见问题速查

| 问题       | 可能原因     |
| -------- | -------- |
| API 无返回  | 未配置白名单   |
| 返回空数组    | 参数限制过多   |
| 获取不到 IP  | 当前地区资源不足 |
| 程序结果为空   | 解析异常     |
| API 偶尔为空 | 请求频率过高   |

***

### 🆘 仍未解决？

如果问题仍未解决，请联系官方客服。（[官网](https://www.ipwo.net/)右侧在线客服）

👉 建议提供：

* API 请求地址（隐藏敏感信息）
* 当前服务器 IP
* 请求参数
* 返回结果截图

***

### 总结

API 返回为空通常由以下原因导致：

```
未配置白名单
↓
参数限制过多
↓
地区资源不足
↓
请求频率过高
```

👉 建议先使用基础参数测试，再逐步增加条件

***