理解提取接口：获取代理IP的核心入口
对于需要使用代理IP的开发者或业务人员来说，API提取接口是与天启代理服务进行交互的核心。你可以把它想象成一个自动售货机，你发送一个特定的指令（请求），它就会按照你的要求，吐出你需要的代理IP。这个接口的灵活性和稳定性，直接决定了你获取IP资源的效率和后续工作的顺畅度。天启代理的提取接口设计以快捷稳定著称，旨在让用户能在一秒内获得可用的IP资源，为业务运行打下坚实基础。
接口基础参数详解
调用提取接口，通常需要几个基础参数来告诉系统你的基本需求。这些参数构成了请求的骨架。
1. 授权密钥（Key/Secret）： 这是你的身份凭证，相当于打开资源库的钥匙。天启代理支持终端IP授权和账号密码授权两种方式，保障账号与资源安全。在API请求中，通常以 `key` 或 `secret` 参数传递，系统通过它来验证你的权限和计费账户。
2. 提取数量（num）： 这个参数指定你一次想获取多少个代理IP。天启代理的接口支持高并发调用，你可以根据业务的实际并发需求来设置这个值。例如，设置 `num=10` 表示一次性提取10个可用IP。
3. 协议类型（protocol）： 你需要指定代理IP的协议。天启代理提供HTTP、HTTPS和SOCKS5三种协议支持，以满足从网页浏览到复杂数据传输等各类业务场景。你可以根据目标网站的协议或客户端支持情况来选择。
高级过滤与定制参数
为了让提取的IP更符合你的具体场景，天启代理的API提供了丰富的高级过滤参数，实现精准获取。
1. 地域限制（city/region）： 如果你需要特定地区的IP，可以使用地域参数。天启代理在全国拥有200多个城市节点，自建机房，你可以指定省份或城市代码来获取对应地区的IP，这对于一些有地域性要求的业务非常有用。
2. 去重模式（dedup）： 避免短时间内获取到重复的IP对于某些业务至关重要。天启代理提供多种去重模式可选，例如支持24小时自动去重，确保在你指定的时间窗口内不会返回相同的IP地址，你也可以根据需求按需过滤重复资源。
3. 存活时间（duration）： 这个参数与你选择的IP产品类型相关。例如，如果你使用的是长效静态IP套餐，你可以期望IP在1-24小时内稳定可用；若使用短效动态IP，则存活时间在3-30分钟。在提取时，系统会返回符合对应套餐时长的IP。
4. 返回格式（format）： 指定你希望接口返回数据的格式，常见的有 `json`、`text` 等。天启代理的API设计灵活，返回结构清晰，便于你直接解析使用。
接口响应解读与错误处理
成功调用接口后，你会收到一个响应。正确的响应通常包含一个IP列表，每个IP条目会包含IP地址、端口、协议、地理位置、过期时间等详细信息。
如果调用失败，响应中会包含错误代码（code）和错误信息（msg）。常见的错误可能包括：授权失败（密钥错误）、余额不足、参数格式错误、提取数量超限等。天启代理的技术文档会提供完整的错误码列表，帮助你快速定位和解决问题。其专业技术客服团队也能提供724小时的支持，协助处理接口调用中的任何疑难。
一个简单的调用示例
假设你已拥有天启代理的授权密钥，需要获取5个支持HTTPS协议的代理IP，并以JSON格式返回。一个简化的HTTP GET请求示例如下：
https://api.tianqiip.com/getip?key=你的授权密钥&num=5&protocol=https&format=json
调用后，你可能会收到如下结构的响应（示例数据）：
{
"code": 0,
"msg": "success",
"data": {
"count": 5,
"proxy_list": [
{"ip": "1.2.3.4", "port": 8080, "expire_time": "2023-10-01 12:00:00", "city": "北京"},
{"ip": "5.6.7.8", "port": 8888, "expire_time": "2023-10-01 12:05:00", "city": "上海"}
// ... 更多IP
]
}
}
常见问题QA
Q1：调用提取接口，返回“无可用资源”是什么原因？
A1：这通常表示当前符合你筛选条件（如特定城市、协议）的IP池暂时被提取完毕。可以尝试稍等片刻再请求，或放宽筛选条件（如不指定城市）。天启代理的IP池基于自建机房纯净网络，资源丰富，IP可用率在99%以上，通常能快速恢复。
Q2：提取到的IP连接失败或速度慢怎么办？
A2：请检查你使用的协议（HTTP/HTTPS/SOCKS5）是否正确。由于网络环境的瞬时波动，个别IP可能出现不稳定。天启代理的IP平均响应延迟≤10毫秒，若遇到问题，建议通过API重新提取更换IP，并确保你的本地网络环境正常。
Q3：如何保证提取的IP不重复？
A3：天启代理的API提供了强大的去重参数（`dedup`）。你可以在调用时启用“24小时自动去重”模式，系统会确保在接下来的24小时内不会分配给你已经使用过的IP，这对于数据采集等需要避免IP重复访问的场景非常有帮助。
Q4：API调用有频率限制吗？
A4：为了保障所有用户的公平使用和系统稳定，天启代理的API会有合理的频率限制。具体限制会根据你的套餐有所不同。其企业级代理服务采用高性能集群架构，能支持较高的并发调用，满足业务爆发性增长的需求。如有特殊高频需求，可以咨询客服了解定制服务。
熟练掌握提取接口的各项参数，就像掌握了高效获取代理资源的遥控器。通过灵活组合天启代理API提供的各种选项，你可以精准地获取到最适合当前业务场景的代理IP，从而保障后续自动化流程或手动操作的顺畅与高效。
