什么是天启代理API接口
天启代理API接口是天启HTTP为用户提供的一种程序化获取代理IP的方式。通过一个简单的HTTP请求，你就能从天启的IP池中批量提取可用的代理IP地址，无需手动在网页上逐个复制。
对于需要大量代理IP的业务场景——比如数据采集、SEO监测、电商比价、账号管理等——API接口可以实现自动化、高效率的IP获取流程，让你的程序按需调用、即取即用。
天启HTTP专注于国内代理IP服务，覆盖全国多个省市节点，提供动态短效代理、独享代理、隧道代理等多种产品类型，满足不同业务场景的需求。
使用API接口的前置准备
在调用API之前，你需要完成以下准备工作：
第一步：注册账号
访问天启HTTP官网，使用手机号注册一个账号并完成登录。
第二步：选择套餐
根据你的业务需求选择合适的代理产品。天启HTTP提供多种套餐，按提取量和并发数区分，你可以根据实际使用场景灵活选择。
第三步：获取API链接
登录用户中心后，进入「API提取」页面，系统会为你生成一个专属的API提取链接。这个链接包含了你的身份认证信息，请妥善保管。
第四步：配置白名单
为了保障账号安全，你需要在用户中心绑定服务器IP白名单。只有在白名单中的IP才能使用你提取的代理IP，防止账号被盗用。
API接口参数详解
天启代理API支持多种参数配置，让你可以精准控制提取的IP类型和数量。以下是常用参数说明：
| 参数名 | 说明 | 示例值 |
|---|---|---|
| num | 提取IP数量（每次最多提取数量取决于套餐） | 10 |
| type | 返回数据格式：txt / json | json |
| pro | 指定省份（留空则随机分配） | 北京 |
| city | 指定城市（留空则随机分配） | 北京 |
| yys | 指定运营商：电信 / 联通 / 移动 | 电信 |
| port | 代理协议类型：1为HTTP，2为HTTPS | 2 |
| ds | 返回方式：1为JSON，2为TXT | 1 |
| lb | 分隔符：1为\r\n，2为\n，3为空格 | 1 |
通过组合这些参数，你可以灵活地获取符合业务需求的代理IP。例如，如果你需要10个北京的HTTPS代理IP，返回JSON格式，就可以在API链接中设置对应参数。
Python调用API示例
下面是一个使用Python调用天启代理API并获取代理IP的完整示例：
import requests
# 天启代理API提取链接（请在用户中心获取你自己的链接）
api_url = "https://api.tianqiip.com/getip?num=10&type=json&pro=&city=&yys=&port=2&time=5&ds=1&lb=1"
def fetch_proxy_list():
"""调用天启API获取代理IP列表"""
try:
response = requests.get(api_url, timeout=10)
if response.status_code == 200:
data = response.json()
if data.get("code") == 0:
proxy_list = data.get("data", [])
print(f"成功获取 {len(proxy_list)} 个代理IP")
for proxy in proxy_list:
print(f"IP: {proxy['ip']}:{proxy['port']} 过期时间: {proxy['expire_time']}")
return proxy_list
else:
print(f"API返回错误: {data.get('msg')}")
else:
print(f"HTTP请求失败，状态码: {response.status_code}")
except Exception as e:
print(f"请求异常: {e}")
return []
def use_proxy(proxy_info):
"""使用代理IP发送请求"""
proxies = {
"http": f"http://{proxy_info['ip']}:{proxy_info['port']}",
"https": f"http://{proxy_info['ip']}:{proxy_info['port']}"
}
try:
resp = requests.get("https://httpbin.org/ip", proxies=proxies, timeout=10)
print(f"通过代理访问结果: {resp.json()}")
except Exception as e:
print(f"代理使用失败: {e}")
if __name__ == "__main__":
proxy_list = fetch_proxy_list()
if proxy_list:
use_proxy(proxy_list[0])
这段代码实现了两个核心功能：调用API批量提取代理IP和使用代理IP发送请求。你可以根据自己的业务需求进行扩展。
Java调用API示例
如果你使用Java进行开发，下面是一个调用天启代理API的示例代码：
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import org.json.JSONObject;
import org.json.JSONArray;
public class TianqiProxyDemo {
// 天启代理API提取链接
private static final String API_URL = "https://api.tianqiip.com/getip?num=5&type=json&port=2&ds=1&lb=1";
public static void main(String[] args) {
try {
// 调用API获取代理IP
String response = fetchProxyList();
JSONObject json = new JSONObject(response);
if (json.getInt("code") == 0) {
JSONArray data = json.getJSONArray("data");
System.out.println("成功获取 " + data.length() + " 个代理IP");
for (int i = 0; i < data.length(); i++) {
JSONObject proxy = data.getJSONObject(i);
System.out.println("IP: " + proxy.getString("ip")
+ ":" + proxy.getInt("port")
+ " 过期时间: " + proxy.getString("expire_time"));
}
} else {
System.out.println("API返回错误: " + json.getString("msg"));
}
} catch (Exception e) {
e.printStackTrace();
}
}
private static String fetchProxyList() throws Exception {
URL url = new URL(API_URL);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setConnectTimeout(10000);
conn.setReadTimeout(10000);
BufferedReader reader = new BufferedReader(
new InputStreamReader(conn.getInputStream(), "UTF-8")
);
StringBuilder response = new StringBuilder();
String line;
while ((line = reader.readLine()) != null) {
response.append(line);
}
reader.close();
return response.toString();
}
}
API调用最佳实践
在实际使用中，有几个关键点需要注意，可以让你的代理IP使用更加稳定高效：
1. 合理控制提取频率
不要过于频繁地调用API接口。建议根据业务实际需求设置提取间隔，避免触发频率限制。通常每次提取足够数量的IP，在本地维护一个IP池，按需取用。
2. 本地维护IP池
建议在本地搭建一个简易的IP池管理模块，将API获取的IP存入队列，定期检测可用性，剔除失效IP，补充新IP。这样可以大幅提升业务稳定性。
3. 异常处理与重试机制
代理IP在使用过程中可能会遇到连接超时、被封禁等情况。务必在代码中加入完善的异常处理和自动重试逻辑，切换到下一个可用IP继续执行。
4. 选择合适的代理类型
天启HTTP提供多种代理类型，根据业务场景选择最合适的：
| 代理类型 | 特点 | 适用场景 |
|---|---|---|
| 动态短效代理 | IP有效期短（1-5分钟），自动轮换 | 高频数据采集、大并发任务 |
| 独享代理 | IP独享使用，稳定性高 | 账号管理、需要固定IP的业务 |
| 隧道代理 | 固定入口地址，自动切换出口IP | 无需管理IP池的场景，开发简单 |
常见问题
Q: API调用返回错误码是什么意思？
常见的错误码包括：code=0表示成功；code=-1表示参数错误；code=-2表示余额不足；code=-3表示提取频率过快；code=-4表示白名单未绑定。具体错误信息会通过msg字段返回，请根据提示进行排查。
Q: 每次最多可以提取多少个代理IP？
单次提取数量取决于你购买的套餐规格。一般来说，单次提取上限在1-50个之间。如果需要更多IP，建议多次调用或联系客服升级套餐。
Q: 提取的代理IP有效期是多久？
不同代理类型的有效期不同。动态短效代理通常为1-5分钟，独享代理可以按需设置更长的有效期。API返回数据中会包含每个IP的过期时间，请在此时间前使用。
Q: 如何绑定IP白名单？
登录天启HTTP用户中心，在「白名单管理」页面添加你服务器的公网IP地址即可。白名单生效后，只有绑定的IP才能使用提取的代理IP，有效保障账号安全。
Q: API接口支持哪些返回格式？
天启代理API支持TXT和JSON两种返回格式。TXT格式简洁，适合简单场景；JSON格式包含更多信息（如过期时间、城市等），推荐在正式业务中使用。
Q: 代理IP连接不上怎么办？
首先检查白名单是否正确绑定；其次确认代理IP是否已过期；最后检查目标网站是否封禁了该IP。如果问题持续，可以联系天启HTTP客服获取技术支持。
