先说人话：提取接口到底在干什么
很多人第一次接触代理IP，会以为"提取接口"是个很玄的东西。其实它的本质特别简单——你发一个网页请求过去，对方的服务器回给你一串可用代理IP的地址和端口，就这么回事。
打个比方：你去饭店点菜，你跟服务员说"我要 5 个菜，清单给我"，服务员回你一张单子。提取接口里的"5 个菜"就是你要几个IP，"清单"就是返回给你的 IP 列表。剩下的工作，是你要把这串 IP 拿去填到自己的程序、爬虫、多开工具或者指纹浏览器里。
所以要调通这个接口，你只需要搞清楚三件事：怎么发请求、回来的数据长什么样、被拦住的时候提示是什么意思。这三件事捋顺了，剩下的都是复制粘贴的活。
第一步：接口怎么调，三行代码就能跑起来
绝大多数代理IP服务商的提取接口都是一个标准的 HTTP GET 请求，你把参数拼在链接后面就能拿到结果。以天启HTTP为例，你在后台生成一条提取链接之后，用浏览器直接打开它都能看到返回内容——这意味着它非常好调试。
下面是 Python 里最常见的调用写法，参数含义我在注释里都标好了：
import requests
# 这里换成你在后台生成的提取链接
API_URL = "https://你的提取链接"
params = {
"num": 5, # 本次要提取几个IP
"format": "json", # 返回格式，json 或 txt
"protocol": "http" # 需要的协议类型
}
resp = requests.get(API_URL, params=params, timeout=10)
print(resp.status_code) # 先看 HTTP 状态码
print(resp.text) # 再看返回内容
调完之后，第一件事不是急着写业务逻辑，而是先手动访问一遍链接，把原始返回内容看清楚。这一步能帮你排除掉一大半"接口报错"的困惑，因为很多问题其实不是代码问题，是链接本身参数配错了。
拿到 IP 之后，怎么塞进请求里？如果你用的是 requests，就是一行代理配置的事：
data = resp.json()
for item in data.get("data", []):
proxy = f"http://{item['ip']}:{item['port']}"
try:
r = requests.get(
"https://你要访问的地址",
proxies={"http": proxy, "https": proxy},
timeout=8
)
print(proxy, "可用", r.status_code)
except Exception as e:
print(proxy, "失效", e)
注意这里一定要加 timeout。不加超时，一个卡死的代理IP能让你整个程序挂在那里不动，这是新手最常踩的坑之一。
第二步：返回格式长什么样
提取接口一般支持两种返回格式：纯文本（txt）和 JSON。
纯文本格式最省事，一行一个 IP，格式是 ip:端口，直接按行切分就能用，适合 Shell 脚本或者简单的配置注入。JSON 格式信息更全，适合写进正式项目里。
JSON 返回通常长成这样：
{
"code": 0,
"msg": "success",
"data": [
{
"ip": "1.2.3.4",
"port": 8080,
"expire_time": 300,
"protocol": "http"
},
{
"ip": "1.2.3.5",
"port": 8080,
"expire_time": 300,
"protocol": "http"
}
]
}
几个关键字段必须看懂：
| 字段 | 含义 | 使用要点 |
|---|---|---|
| code | 业务状态码 | 先判断这个，非成功值直接中断逻辑 |
| msg | 提示信息 | 出错时靠它定位原因 |
| ip | 代理服务器地址 | 拼成 URL 时注意别多加空格 |
| port | 端口号 | 是数字类型，做字符串拼接要转换 |
| expire_time | 剩余可用秒数 | 短效IP一定要盯着它，提前续提 |
| protocol | 协议类型 | http / https / socks5，别用错 |
特别提醒 expire_time 这个字段。短效代理IP是有寿命的，比如 1 分钟、5 分钟、30 分钟。如果你的程序一口气提了 100 个 IP，然后慢慢用，很可能用到第 80 个的时候，前面 20 个早就过期了。正确做法是边用边提、按需提取，或者用一个小的 IP 池把快过期的淘汰掉。
第三步：为什么你总被限流
"我代码没错啊，为什么一会儿就返回失败了？"——十有八九是撞上了限流。限流不是服务商故意为难你，而是为了保护资源池不被单个用户瞬间抽干。常见的限流分四个维度：
1. 身份鉴权。提取链接里通常带有一个密钥或者订单号，链接被泄露、复制不完整、多了空格，都会导致鉴权失败。很多人喜欢把链接存在配置文件里，结果复制的时候把换行符也复制进去了，排查半天。
2. 提取间隔。大部分接口都有一个"最短提取间隔"，比如两次提取之间必须间隔几秒。如果你的程序写在 for 循环里疯狂调用，前几次成功，后面全部失败。解决办法很简单：一次性提够了缓存起来，别一IP一提取。
3. 单次数量上限。接口一般会限制一次最多能取多少个 IP，你填了个远超上限的数字，要么被截断，要么直接报错。这种情况看一下返回的 msg 就能明白。
4. 并发与用量上限。同一时间能发起多少个提取请求、一天总共能提多少个，通常也有额度。这类限制在业务量上来之后才会遇到，提前做好失败重试和数据缓存就能绕开。
一个成熟的调用节奏是：批量提取 → 放进本地池子 → 用完再补 → 失败自动重试并降速。别把接口当数据库用，每来一个请求就调一次接口，那不是接口设计的使用方式。
第四步：错误码到底在说什么
错误码是排查问题的"病历单"。不同服务商的编码规则不一样，但含义基本逃不出下面这几大类，遇到报错可以按这张表对号入座：
| 类型 | 典型提示 | 真实原因与处理办法 |
|---|---|---|
| 鉴权类 | 401 / 密钥错误 | 提取链接不完整、被截断、含多余空格或换行，重新从后台复制完整链接 |
| 权限类 | 403 / 无访问权限 | IP 白名单没有加当前服务器出口IP，或者用的是别人的链接 |
| 频率类 | 429 / 请求过于频繁 | 两次提取间隔太短，加 sleep 或改成批量提取 |
| 参数类 | 400 / 参数不合法 | num 超上限、format 拼错、protocol 填了不支持的协议 |
| 资源类 | 无可用IP / 资源不足 | 当前线路被抽空，稍后重试或改用其他地区线路 |
| 额度类 | 余额不足 / 超出套餐 | 剩余可提取数量用完了，需要续费或用其他订单 |
| 服务类 | 500 / 系统繁忙 | 偶发问题，做 2~3 次指数退避重试，别死循环狂刷 |
排查顺序建议固定下来：先看 HTTP 状态码 → 再看返回里的 code 和 msg → 最后才怀疑自己的业务代码。这个顺序反过来，很多人会在代码里找半天错，结果发现是白名单没配。
接口调通之后，IP 资源从哪来
把接口调通只是第一步，真正决定你业务跑不跑得动的，是背后的 IP 资源池稳不稳。天启HTTP 是专注国内市场的代理IP服务商，提供全国多地区节点、支持 HTTP/HTTPS/SOCKS5 协议、提供 API 提取、隧道代理和独享代理等多种形态，接口文档清晰，返回格式规范，接入成本很低。
需要说清楚两点：天启HTTP 的服务范围是国内代理IP，不适用于需要海外 IP 的业务场景；同时平台不提供住宅IP，如果你需要的是机房级、稳定可调度的国内代理IP，那它是对得上的。
对于开发者最关心的几个点——提取频率、单次数量、并发额度、白名单绑定方式——在后台的套餐说明和接口文档里都写得很明确，选型之前花十分钟读一遍，能省掉后面几小时的调试。
五个能立刻少踩坑的小建议
1. 先用浏览器手动调一次。能看到返回内容，就说明链接没问题，剩下的才是代码问题。
2. 把 code 判断写在最前面。不要在没判断成功与否的情况下直接去读 data 字段，否则一报错就是空指针异常。
3. 永远加超时。请求代理、使用代理，两个环节都要设 timeout。
4. 做一个小型IP池。维护一个可用列表，定时剔除失效的、补齐新的，比每次临时提取稳得多。
5. 日志要打全。把原始返回内容、使用的代理、失败原因都记下来，出问题的时候能一眼看出是接口问题还是目标网站问题。
常见问题
Q：提取接口返回 200，但 code 不是 0，是怎么回事？
HTTP 200 只代表"请求成功送到服务器"，业务有没有成功要看返回体里的 code 和 msg。这是两套体系，别混在一起判断。
Q：返回的 IP 拿到手就是不能用的，是不是接口坏了？
先手动测一下这个 IP 能不能连目标网站。如果目标网站本身有限制，或者你请求太快被目标站拦了，表现和"代理坏了"一模一样。建议换一个目标站点做对照测试。
Q：为什么我提 100 个 IP，只有前几个能用？
基本可以判定是 IP 有效期的问题。短效 IP 存活时间短，一次提太多，后面的还没轮到就已经过期了。改成按需分批提取，或者用长效/独享类型的产品。
Q：txt 和 json 格式该选哪个？
临时测试、写脚本、往配置文件里灌，用 txt 更快；写进正式项目、需要知道每个 IP 的有效期和协议，用 json 更省心。
Q：程序部署到服务器后接口就一直报无权限？
这是白名单问题。很多接口会校验调用方的出口 IP，你在本机调通不代表服务器能调通，记得把服务器的出口 IP 加到白名单里。
Q：接口调用要不要做重试？
要，但要有节制。建议 2 到 3 次，并且每次间隔递增（比如 1 秒、3 秒、9 秒）。无脑死循环重试只会让限流更严重，反而解决不了问题。
