API 白名单

平台的所有代理产品均需要在海外网络环境下使用，海外网络环境需要客户自行配置。

本文将介绍如何在 Ip2up平台 为动态住宅代理配置 API 白名单，以便通过 API 接口安全地获取代理信息。

1. 添加白名单 点击 添加到白名单 按钮，系统将自动将您当前的公网 IP 添加至白名单。 2. 删除白名单 IP 在白名单列表中，找到需要删除的 IP 地址，点击右侧的删除按钮即可移除。

3. 批量添加白名单 如需手动添加多个 IP 地址：

API 参数说明

参数	类型	必填	说明
`mode`	string	是	会话类型：`rotating`（轮换 IP）、`sticky`（粘性 IP）
`host`	string	是	代理网关地址
`protocol`	string	是	代理协议：`http` 或 `socks5`
`country`	string	否	国家代码，如 `US`（不填则随机）
`state`	string	否	州/地区代码，如 `AK`（需配合 country 使用）
`city`	string	否	城市名称，如 `Bethel`（需配合 country、state 使用）
`count`	int	是	生成代理数量，支持 1 至 100
`format`	string	是	输出格式：`txt`（文本格式）、`json`（JSON 格式）
`sessionTime`	int	否	粘性 IP 持续时间（分钟），1 至 70，仅在 `mode=sticky` 时生效

配置步骤 1. 选择地理位置

2. 选择代理格式

3. 选择代理协议 支持 HTTP 和 SOCKS5 两种代理协议，请根据实际使用场景选择。 4. 选择代理地址 系统将根据您的配置自动分配可用的代理网关地址。 5. 配置会话类型

6. 设置生成数量 选择需要生成的代理数量，支持 1 至 100 之间的任意整数。

✅ 至此，已成功配置动态住宅代理的 API 白名单，并可通过 API 链接获取代理信息。