做数据采集、批量任务或自动化脚本时，最麻烦的往往不是写业务逻辑，而是让程序持续拿到"能用"的代理IP。手动复制粘贴效率太低，也撑不起高并发。API提取就是为解决这个问题而生的标准接入方式：平台给你一条提取链接，程序请求它就能批量拿到可用IP，全程自动。这篇文章从原理、准备、接入步骤到多语言代码示例，带你把整个流程完整跑通。
什么是API代理提取
一句话概括：用一条链接，换一批IP。你在服务商后台设置好参数（提取数量、返回格式、地区等），系统会生成一条专属提取链接。程序向这条链接发起普通的GET请求，就能收到形如 113.120.xx.xx:4231 的IP列表，一行一个；也可以选JSON格式，附带端口、地区、过期时间等字段，方便程序做精细化调度。
它的完整链路可以拆成四步：
除了API提取，市面上还有账密认证等常见使用方式，两者的核心区别在于IP由谁管理：
| 对比项 | API提取 | 账密认证 |
|---|---|---|
| 获取方式 | 先请求链接拿IP列表 | 请求时直接带账号密码 |
| IP管理 | 自己维护本地IP池 | 由服务商自动分配 |
| 适合场景 | 大规模采集、精细调度 | 快速接入、小规模任务 |
本文以API提取为主线。如果你使用的是天启HTTP，登录后台后的"API提取"页面就是接入起点。
接入前要做的四项准备
很多人接入失败，问题都出在准备环节。动手写代码之前，先把下面四件事确认好：
1. 绑定白名单：提取链接通常要求发起请求的机器IP在白名单内。提前把你服务器的公网IP加进后台，否则请求会直接被拒。
2. 选好返回格式：TXT一行一个最通用，适合大多数采集脚本；需要按地区、有效期做调度时，选JSON更好解析。
3. 确认频率与并发上限：套餐一般对提取频率、同时可用IP数有限制，接入前看清规则，避免程序跑到一半被限流。
4. 设计重试逻辑：代理IP是消耗品，单个IP随时可能失效。代码里必须有"失败就换下一个"的兜底逻辑，这是能否长期稳定运行的关键。
通用接入五步走
准备就绪后，接入本身其实很简单，按下面五步走：
第一步：登录天启HTTP后台，在API提取页面设置提取数量、返回格式等参数，生成并复制提取链接。
第二步：把发起请求的服务器公网IP加入白名单。
第三步：先用浏览器或curl手动请求一次提取链接，确认能正常返回IP列表：
curl "你的API提取链接"
# 返回示例（TXT格式，一行一个）：
# 113.120.xx.xx:4231
# 183.57.xx.xx:8080第四步：把提取和解析逻辑写进代码（参考下一节的示例）。
第五步：把解析出的IP挂到业务请求上，设置10秒以内的超时，并加上失败重试。
代码示例：从提取到使用
下面给出几种常用语言的最小可运行示例，思路完全一致：请求提取链接 → 解析IP列表 → 挂载代理 → 失败重试。
Python：
import requests
API_URL = "你的API提取链接" # 在天启HTTP后台复制
TARGET = "https://httpbin.org/ip" # 替换成你的目标网站
def get_proxies(num=5):
"""请求提取链接，返回IP列表"""
resp = requests.get(API_URL, params={"num": num}, timeout=10)
resp.raise_for_status()
return [line.strip() for line in resp.text.splitlines() if line.strip()]
def fetch_with_proxy(proxy_ip):
"""用单个代理请求目标网站"""
proxies = {"http": f"http://{proxy_ip}", "https": f"http://{proxy_ip}"}
return requests.get(TARGET, proxies=proxies, timeout=10)
if __name__ == "__main__":
for ip in get_proxies():
try:
r = fetch_with_proxy(ip)
print(ip, "->", r.status_code, r.text.strip()[:60])
except Exception as e:
print(ip, "失效，自动跳过：", e)提示：提取链接支持的参数（如数量、格式）以后台说明为准；如果选了JSON格式，用 json.loads(resp.text) 解析后按字段取值即可。
PHP：
<?php
$api = "你的API提取链接";
$list = explode("\n", trim(file_get_contents($api)));
$ch = curl_init("https://httpbin.org/ip");
curl_setopt($ch, CURLOPT_PROXY, trim($list[0]));
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);
curl_close($ch);Java：思路相同，用 Proxy 对象挂载代理即可：
Proxy proxy = new Proxy(Proxy.Type.HTTP,
new InetSocketAddress("113.120.xx.xx", 4231)); // IP来自提取结果
HttpURLConnection conn = (HttpURLConnection)
new URL("https://httpbin.org/ip").openConnection(proxy);
conn.setConnectTimeout(10000);让程序长期稳定跑的五个建议
跑通第一个请求只是开始，想在生产环境长期稳定运行，还要注意以下几点：
1. 管理IP有效期：提取时留意返回的过期时间，优先使用剩余时间长的IP，短效业务按批次整体轮换。
2. 建本地缓存池：不要每个请求都去提取一次。单次多提一些放进本地队列，用完或失效再补，既节省提取次数，整体速度也更快。
3. 快速失败：代理请求的超时建议控制在10秒以内，失败立即切换下一个IP，不要死等。
4. 失败标记与剔除：连续失败的IP直接从本地池剔除，避免反复撞同一个"坏IP"。
5. 监控成功率：按IP记录成功率和响应耗时，低于阈值就淘汰，问题早发现早处理。
为什么推荐天启HTTP
选国内代理服务商，重点看三样：IP池规模、可用率、响应速度。天启HTTP是国内IP代理服务商，自建机房，IP资源充足，支持HTTP/HTTPS/SOCKS5等常用协议；后台提供API提取链接，提取数量、返回格式等参数均可按需设置，接入文档和示例齐全，遇到问题也有技术支持响应。
对开发者来说，接入成本往往比价格更重要：文档清晰、提取接口规范、返回格式稳定，意味着你可以把时间花在业务逻辑上而不是踩坑上。注册后在后台拿到提取链接，按本文流程走一遍，通常半小时内就能跑通第一个代理请求。
常见问题
Q：请求提取链接返回为空或报错怎么办？
先检查三件事：服务器公网IP是否已加入白名单、提取频率是否超限、账户是否有剩余额度。可以在服务器上用curl手动请求一次，根据返回的错误提示定位，多数问题都出在白名单没绑定上。
Q：提取到的IP很快失效，正常吗？
正常。代理IP本身有生命周期，短效套餐失效速度更快。正确姿势是"用前校验 + 失败重试"：使用前做一次快速可用性检测，失效立即换下一个，业务层面不要假设每个IP都能用满全程。
Q：一条提取链接能给多台服务器用吗？
可以，但要把每台机器的公网IP都加入白名单，并注意套餐的并发上限。机器较多时，建议各机分开提取、各自维护本地IP池，避免互相挤占额度。
Q：提取频率有上限吗？怎么减少提取次数？
有，具体以套餐和后台说明为准。最有效的办法是本地缓存池：单次多提一些，用完再补，而不是每个请求都提取一次，这样既不容易触发限流，整体速度也更快。
Q：不会写代码也能用API提取吗？
可以。提取链接用浏览器打开就能看到IP列表，把IP填进火车头、八爪鱼这类采集工具的代理设置里即可使用；接入过程中遇到问题，也可以直接联系天启HTTP的客服协助排查。
