API代理IP接口对接，到底是个啥？
简单来说，你有一个程序（比如爬虫、数据采集工具），需要换着不同的IP地址去访问目标网站，以避免被限制。而“天启代理”这样的服务商，提供了一个“IP池子”的取水口，也就是API接口。你的程序通过调用这个取水口，就能实时、自动地获取到新鲜可用的代理IP，然后拿去用。对接，就是让你的程序学会怎么从这个取水口稳定、高效地取水。
对接前，你需要准备什么？
对接前，你主要需要两样东西：一是从天启代理获取的API接口地址，二是用于身份验证的授权密钥。通常，你注册天启代理账号后，在用户中心就能找到这些信息。天启代理支持两种主流的授权方式：终端IP授权（将你服务器的公网IP绑定到白名单）和账号密码授权（在API请求头中携带用户名密码）。前者更安全，适合固定服务器部署；后者更灵活，适合本地调试或动态IP环境。
核心步骤：如何调用API获取IP？
天启代理的API设计通常遵循RESTful风格，调用起来非常直观。整个过程可以概括为：构造请求 -> 发送请求 -> 处理返回的IP。下面是一个最基础的HTTP GET请求示例，假设我们获取一个支持HTTPS协议的动态IP。
你需要找到你的专属API链接，它通常长这样：http://api.tianqiip.com/getip?key=你的密钥&num=1&type=json&protocol=1
让我们拆解一下这个链接里的参数：
- key: 你的个人密钥，这是必须的。
- num: 你想一次获取几个IP，比如1个。
- type: 返回数据的格式，json是最常用的。
- protocol: 协议类型，1代表HTTP/HTTPS。
发送这个请求后，你会收到一个JSON格式的响应，里面就包含了可用的代理IP信息。
示例代码：用Python快速上手
理论讲完，我们来点实际的。以下是一段Python代码，演示如何调用天启代理API获取一个IP，并用这个IP去访问一个示例网站。
import requests
你的天启代理API配置
api_url = "http://api.tianqiip.com/getip"
params = {
'key': 'YOUR_API_KEY_HERE', 请替换为你的实际密钥
'num': 1, 获取1个IP
'type': 'json', 返回json格式
'protocol': 1, 1:HTTP/HTTPS, 2:SOCKS5
'time': 10 IP有效时长（分钟），根据套餐可选
}
步骤1：调用API获取代理IP
try:
resp = requests.get(api_url, params=params, timeout=10)
ip_data = resp.json()
if ip_data['code'] == 200: 假设成功返回码为200
proxy_ip = ip_data['data'][0]['ip']
proxy_port = ip_data['data'][0]['port']
print(f"获取到的代理IP：{proxy_ip}:{proxy_port}")
else:
print(f"获取IP失败：{ip_data.get('msg')}")
exit()
except Exception as e:
print(f"请求API异常：{e}")
exit()
步骤2：使用获取到的代理IP访问目标网站
target_url = "https://httpbin.org/ip" 一个用于测试返回自身IP的网站
proxies = {
'http': f'http://{proxy_ip}:{proxy_port}',
'https': f'http://{proxy_ip}:{proxy_port}', 注意：如果协议是HTTP，这里也写http://
}
try:
response = requests.get(target_url, proxies=proxies, timeout=15)
print("使用代理IP访问成功，返回内容：")
print(response.text)
except requests.exceptions.ProxyError:
print("代理连接失败，可能IP已失效或网络不通。")
except Exception as e:
print(f"访问目标网站时发生错误：{e}")
这段代码清晰地分为两步。第一步是取IP，第二步是用IP。天启代理的API响应速度快（通常<1秒），且IP可用率高（≥99%），这保证了你的业务程序能稳定、连续地获取到优质资源。
进阶技巧与最佳实践
掌握了基础调用后，为了让你的程序更健壮，可以考虑以下几点：
1. 异常处理与重试机制： 网络请求总有不确定性。务必对API请求和目标访问添加完善的异常捕获（如超时、连接错误）。当获取IP失败或使用IP失败时，加入重试逻辑，比如重试3次，每次间隔2秒。
2. IP有效性验证： 虽然天启代理的IP可用率很高，但极端情况下也可能拿到不可用的。你可以在使用前，用获取到的IP快速访问一个稳定的、已知的网站（如百度）来验证其连通性和速度，通过验证后再投入正式任务。
3. 连接池与IP复用： 对于需要高并发的场景，不要每次请求都去获取一个新IP。可以一次性获取一批IP放入连接池管理，并设置合理的IP复用策略（根据业务需求，在有效期内复用）。天启代理支持多种去重模式，可以有效配合你的连接池，避免拿到重复IP。
4. 遵守目标网站规则： 使用代理IP是为了更顺畅地进行数据交互，而不是进行攻击。请合理设置请求频率，尊重网站的Robots协议，避免给目标网站服务器造成过大压力。
常见问题QA
Q: 调用API返回错误码，比如“密钥错误”或“余额不足”，怎么办？
A: 请首先登录天启代理用户中心，确认你的密钥填写无误，并查看账户余额是否充足。API接口通常会返回明确的错误信息，根据提示排查即可。
Q: 获取到的代理IP很快失效了，是什么原因？
A: 代理IP本身就有有效期，分为短效（几分钟到半小时）和长效（数小时到一天）。你需要在调用API时通过参数（如示例中的`time`）指定或选择对应套餐。如果目标网站有很强的反爬机制，也可能主动封禁当前使用的代理IP。
Q: 我的程序部署在云服务器上，应该用哪种授权方式？
A: 强烈推荐使用终端IP授权。将你的云服务器公网IP添加到天启代理的白名单中，这样即使API密钥意外泄露，他人也无法从其他IP地址盗用你的资源，安全性更高。
Q: 如何应对需要高匿名度的场景？
A: 天启代理的代理IP池经过纯净网络管理，本身具有较高的匿名性。在调用时，确保你的请求是通过代理转发，且没有在HTTP头中泄露真实的客户端特征（如某些特定的Header）。对于要求极高的场景，可以咨询天启代理的技术客服获取定制化建议。
Q: 除了获取单个IP，API还支持其他功能吗？
A: 是的。天启代理的API功能丰富，除了按需获取IP，通常还支持查询IP余额、获取IP白名单、设置IP有效期、查询使用统计等。具体请查阅天启代理官方提供的详细API文档，根据你的业务需求进行调用。
