API 提取返回 IP:端口后怎么填到工具里？
API 返回 IP:端口后，要拆分主机和端口，并根据白名单或账号密码方式完成认证。本文说明不同工具的字段填写、HTTP/SOCKS5 验证和常见连接失败排查。
API 提取返回的 IP:端口 要拆成两个字段填写：冒号前是主机或代理 IP，冒号后是端口。例如返回 203.0.113.10:8000，工具里的 Host/IP 填 203.0.113.10，Port 填 8000。不要把整串内容粘到主机字段，也不要把冒号带进端口字段。你只需要记住三件事：冒号前填主机，冒号后填端口，是否填写账号密码要看产品的认证方式。
先确认这条代理信息怎么认证
动态住宅代理 IP 的 API 提取通常配合白名单使用。白名单就是允许某个终端出口 IP 使用代理服务的认证方式。终端当前的公网出口 IP 已加入白名单后，提取到的每行 IP:端口 可直接连接，不需要再填账号和密码。若终端公网出口发生变化，应先更新白名单再重试。
如果产品页面明确提供主机、端口、账号和密码，则按账号密码方式填写。不要添加产品说明之外的配置项；普通 HTTP、HTTPS、SOCKS5 代理接入通常只涉及主机、端口、账号、密码或白名单。
不确定各字段分别代表什么时，先查看代理参数说明，再按产品实际提供的认证方式填写。
API 返回多行时怎么读取
API 一次提取多个代理 IP 时，常见结果是一行一个地址：
```text
203.0.113.10:8000
203.0.113.11:8000
203.0.113.12:8000
```
每一行都是一组独立的代理 IP 与端口。工具只允许填写一个代理时，先选其中一行测试；支持批量导入时，再按工具要求保留一行一条的格式。复制前应删除空格、引号、逗号和多余换行。
不同工具里的字段怎么对应
| API 返回内容 | 工具常见字段 | 示例 |
|---|---|---|
| 冒号前的 IP | Host、Server、Proxy Host、主机 | 203.0.113.10 |
| 冒号后的数字 | Port、Proxy Port、端口 | 8000 |
| 产品说明的协议 | HTTP、HTTPS 或 SOCKS5 | 按产品说明选择 |
| 账号密码 | Username/Password | 仅在该连接方式提供时填写 |
在指纹浏览器或代理客户端中，一般按“协议 → 主机 → 端口 → 认证”的顺序填写，保存后点击检查代理或启动连接。系统代理通常只有主机和端口字段；如果系统入口不支持认证，应改用支持相应认证方式的客户端。
不同系统和工具的具体入口可从代理设置帮助选择对应教程，避免把其它客户端的字段位置直接套用过来。
命令行和程序如何验证
先用出口检测页（用来查看目标网站实际看到哪个 IP 的检测页面）确认 IP 是否变化，再访问真实目标 URL。下面仅展示字段位置，地址需替换为实际提取结果。
HTTP 代理 IP 示例：
```bash
curl -x http://203.0.113.10:8000 https://example.com
```
SOCKS5 且需要远端解析时，可使用支持远端 DNS 的写法：
```bash
curl --proxy socks5h://203.0.113.10:8000 https://example.com
```
不要只看命令是否返回内容。还要核对出口 IP、目标站状态码、地区展示和关键业务步骤。
常见失败怎么排查
| 现象 | 优先检查 | 下一步 |
|---|---|---|
| 工具提示格式错误 | 是否把 IP:端口 整串填进一个字段 | 拆分主机和端口 |
| 连接超时 | 本地网络、海外网络环境、端口可达性、资源有效期 | 换网络或重新提取后复测 |
| 407 或认证失败 | 账号密码是否正确，或白名单是否匹配当前公网出口 | 重新复制凭据或更新白名单 |
| 连接成功但出口没变 | 工具是否已启用、代理是否覆盖目标应用 | 检查代理覆盖范围和系统代理冲突 |
| 刚才可用、稍后失效 | 提取结果是否已过有效期 | 重新调用 API 获取新结果 |
| 只有目标站失败 | 状态码、地区限制、Cookie、账号状态和访问频率 | 固定变量后测试同地区另一代理 IP |
如果问题集中在认证环节，可先核对白名单和账号密码的区别，确认当前连接是否还需要填写账号密码。
从填写到验证的完整流程
1. 在动态住宅 API 提取教程确认提取参数、协议和有效期。
2. 将终端公网出口加入白名单，再调用 API 获取 IP:端口。
3. 把 IP 与端口拆开填入工具，选择产品支持的协议。
4. 保存并启用连接，先检查出口 IP 是否变化。
5. 再测试目标 URL、状态码、地区结果和失效时间。
常见问题
IP:端口可以整串粘贴吗？
只有工具明确提供“批量导入”或“代理地址”输入框时才可能支持。普通主机和端口字段必须拆开填写。
API 提取后为什么没有账号密码？
白名单方式下，系统根据终端公网出口识别权限，提取到的 IP:端口 通常可直接使用。应先确认当前终端已经加入白名单。
为什么同一条代理信息过一会儿不能用了？
动态住宅代理 IP 的 API 提取结果通常有有效期。记录提取时间和失效时间，过期后重新获取，不要继续重复测试旧地址。
配置完成后怎样确认生效？
先确认出口检测页显示的 IP 已改变，再验证真实目标站的状态码、地区展示和关键步骤。
配置失败时，准备脱敏后的 API 返回格式、使用工具、协议、错误码、提取时间和出口检测结果，再通过全球代理 FAQ定位对应问题。