代理api提取教程：按次提取与批量提取的接口调用方法

按次提取与批量提取，两种接口怎么选？

当你需要用到代理IP时，可能会遇到两种不同的使用场景。一种是临时、零散的需求，比如偶尔需要换个IP查个资料，或者测试一下某个网站对不同IP的访问限制。另一种则是持续、大量的需求，比如数据采集、自动化测试等业务，需要源源不断地获取大量IP来保证任务顺利进行。

针对这两种截然不同的场景，天启代理提供了两种核心的接口调用方式：按次提取和批量提取。简单来说，按次提取就像“单点”，随用随取，灵活方便；批量提取则是“批发”，一次性获取一批IP，高效稳定。选择哪种，完全取决于你的业务节奏和用量。

按次提取接口：随用随取的灵活方案

按次提取，顾名思义，就是每次通过调用一次API接口，获取一个或少量几个代理IP。这种方式特别适合需求量不固定、使用频率不高的场景。

它的核心特点是“按需索取”。你不需要预先囤积IP，也不用担心IP过期浪费。当你的程序或脚本需要换IP时，就调用一下接口，拿到一个新鲜的IP直接使用。天启代理的接口响应速度很快，请求时间通常在1秒以内，几乎不会让你的业务有等待感。

调用方法也非常简单。你只需要向天启代理提供的特定API链接发送一个GET请求。为了确保安全，通常需要在请求中包含你的授权信息，比如账号密码（天启代理支持账号密码授权和终端IP授权两种方式）。接口会立刻返回一个可用的代理IP和端口。

这里有个简单的伪代码示例，帮助你理解这个过程：

 1. 构建API请求URL（示例，具体参数以天启代理官方文档为准）
api_url = “https://api.tianqiip.com/getip?key=你的密钥&num=1&format=json”
 2. 发送HTTP请求
response = requests.get(api_url)
 3. 解析返回的JSON数据，获取IP和端口
ip_data = response.json()
proxy_ip = ip_data[‘data’][0][‘ip’]
proxy_port = ip_data[‘data’][0][‘port’]
 4. 使用这个proxy_ip:proxy_port进行你的网络操作

使用按次提取时，你可以灵活设置参数，比如指定IP的存活时长（从天启代理提供的3-30分钟短效动态IP中选择）、指定协议（HTTP/HTTPS/SOCKS5）等。这种细粒度的控制，让临时性任务处理起来得心应手。

批量提取接口：持续供能的高效引擎

如果你的业务需要7x24小时不间断运行，并且对代理IP的消耗量很大，那么批量提取接口就是为你设计的。它允许你通过一次接口调用，获取数百甚至数千个代理IP，形成一个IP池供你的程序随时取用。

批量提取的核心优势在于“稳定供应”和“降低请求频率”。你不需要频繁地调用API，避免了因网络波动或请求限制导致获取IP失败的风险。你可以将这些IP存入本地数据库或内存池中，由程序自行管理、轮询使用，从而保证业务流的顺畅。

天启代理的批量提取接口同样高效。其自建机房和纯净网络保证了IP资源的充足与高可用率（≥99%）。调用方式与按次提取类似，但参数上可以设置更大的提取数量。

一个典型的使用流程是：

程序初始化时，调用批量提取接口，获取一大波IP存入本地池。
业务程序需要代理时，直接从本地池中取出一个使用。
设置一个监控任务，当本地池中IP数量低于某个阈值，或IP存活时间即将到期时，再次调用批量接口进行补充。

这种方式特别适合数据采集、价格监控、广告验证等需要高并发、长周期运行的业务。天启代理的分布式集群架构也能很好地支撑这种高并发调用，从容应对业务量的爆发性增长。

关键参数详解与调用注意事项

无论是按次还是批量提取，理解API的关键参数都至关重要。下面这个表格列出了部分通用且重要的参数（请务必以天启代理最新官方API文档为准）：

参数名	说明	常见值示例
key	你的唯一授权密钥，代表账户身份	由天启代理后台提供
num	提取数量	按次提取常为1，批量提取可为10、100等
format	返回数据格式	json、text等
protocol	代理协议	1 (HTTP), 2 (HTTPS), 3 (SOCKS5)
time	IP存活时长（分钟）	3, 5, 15, 30 (短效动态IP)

调用时需要注意：

授权安全：保护好你的key，不要泄露。建议使用终端IP授权方式绑定服务器IP，或定期更换密钥。
频率控制：虽然天启代理接口响应快，但也请根据实际需要合理调用，避免不必要的无效请求。
错误处理：在你的代码中做好异常处理。当接口返回错误码时（如余额不足、参数错误等），应有相应的重试或报警机制。
IP验证：提取到IP后，建议先做一个简单的连通性测试，确保IP可用后再投入正式业务。

常见问题QA

Q：按次提取和批量提取，哪个更划算？
A：这没有绝对答案，取决于你的“用量模式”。如果每天只用几十个IP，且时间分散，按次提取（使用短效动态IP）可能更经济，因为只为实际使用的资源付费。如果用量大且集中，批量提取通常有更好的性价比，并能提升业务稳定性。

Q：提取到的IP马上就用，为什么还是提示失败？
A：任何服务商都无法保证100%的绝对可用率。天启代理的IP可用率在99%以上，但仍有极低概率遇到问题。建议：1. 检查提取参数（如协议）是否与使用方式匹配。2. 在程序中加入重试机制，单个IP失败后自动从池中更换下一个。3. 联系天启代理的技术客服，他们能提供一对一的技术支持，帮你排查问题。

Q：我想让IP来自特定城市，可以做到吗？
A：可以。天启代理拥有全国200+城市节点，其API通常支持地区筛选参数（如`area`）。你可以在调用接口时指定城市或省份，获取对应地区的代理IP，满足一些对地理位置有要求的业务场景。

Q：批量提取的IP，如何管理其有效期？
A：这是使用批量提取的关键。你需要在本地的IP池管理逻辑中，为每个IP记录其提取时间或过期时间。在使用前检查是否过期，并定时清理过期IP，同时触发新的提取任务来补充池子。天启代理提供的IP存活时长非常明确（如3分钟），便于你进行精确管理。