正文

短效代理api接入教程！Python/Java代码示例

天启代理
天启代理 V管理员 /5 阅读
0611

短效代理API是什么？

简单来说，短效代理API就是一个能让你快速获取到一批短期有效代理IP地址的接口。这些IP的有效期通常从几分钟到几十分钟不等，用完后可以再通过API获取新的。这种模式特别适合需要大量、频繁更换IP的应用场景，比如数据采集、价格监控、批量注册验证等。它省去了你手动寻找和测试IP的麻烦，通过几行代码就能实现IP的自动切换，让程序跑得更顺畅。

短效代理api接入教程！Python/Java代码示例

为什么选择天启代理的短效API？

市面上代理服务不少，但用起来体验千差万别。天启代理的短效代理API有几个硬核特点，能让你少踩很多坑：

稳定高速是基础： 它的IP可用率标称在99%以上，响应延迟极低。这意味着你调用API获取IP，或者通过获取到的IP去访问目标网站，速度都很快，不会因为代理不稳定而频繁中断任务。

接入简单不折腾： 天启代理提供了非常清晰的API文档和多种授权方式（如终端IP白名单或账号密码），你不需要配置复杂的客户端，直接通过HTTP请求就能拿到IP，对开发者非常友好。

资源纯净够用： 全国自建机房，拥有200多个城市的节点资源。并且支持按需去重，可以有效避免在短时间内拿到重复的IP地址，这对于需要模拟不同用户访问的场景至关重要。

协议全面： 支持HTTP、HTTPS和SOCKS5三种协议，无论你的爬虫、软件或脚本用的是哪种网络库，基本都能无缝对接。

如何获取并调用API？

使用天启代理的短效API，整个过程可以分为三步：注册获取授权 -> 拼接API链接 -> 在代码中调用。

你需要在天启代理官网注册账号并获取API授权信息。通常你会得到一个API链接，以及授权凭证（可能是你的账号密码，也可能是将服务器IP添加到白名单）。

天启代理的API链接通常像这样：http://api.tianqiip.com/getip?参数1=值1&参数2=值2... 你可以在链接后附加参数来控制获取IP的数量、协议、有效期等。具体参数需要查阅天启代理最新的官方文档。

Python代码示例

下面是一个使用Python的requests库调用天启代理短效API，并利用获取到的IP去访问一个目标网页的简单例子。这里假设使用“终端IP白名单”授权方式（即你的服务器IP已在后台添加）。


import requests

 第一步：从天启代理API获取短效代理IP
api_url = "http://api.tianqiip.com/getip?num=1&type=json&protocol=http&time=3"   示例链接，获取1个http协议，3分钟有效的IP
try:
    resp = requests.get(api_url, timeout=5)
    ip_data = resp.json()
    if ip_data.get("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("获取代理IP失败：", ip_data.get("msg"))
        exit()
except Exception as e:
    print("调用API接口异常：", e)
    exit()

 第二步：使用获取到的代理IP访问目标网站
target_url = "http://httpbin.org/ip"   一个用于测试返回自身IP的网站
proxies = {
    "http": f"http://{proxy_ip}:{proxy_port}",
    "https": f"http://{proxy_ip}:{proxy_port}",   注意：如果API返回是http代理，这里https也写http协议
}
try:
    response = requests.get(target_url, proxies=proxies, timeout=10)
    print("目标网站返回的信息：", response.text)
except requests.exceptions.ProxyError as e:
    print("代理连接错误，此IP可能已失效或不可用：", e)
except Exception as e:
    print("访问目标网站发生错误：", e)

Java代码示例

对于Java开发者，可以使用HttpClient库来实现。同样假设使用白名单授权。


import org.apache.http.HttpHost;
import org.apache.http.client.config.RequestConfig;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.io.IOException;

public class TianQiProxyDemo {
    public static void main(String[] args) {
        // 第一步：调用天启代理API获取IP
        String apiUrl = "http://api.tianqiip.com/getip?num=1&type=json&protocol=http&time=3";
        String proxyIp = null;
        int proxyPort = 0;

        try (CloseableHttpClient client = HttpClients.createDefault()) {
            HttpGet apiRequest = new HttpGet(apiUrl);
            try (CloseableHttpResponse apiResponse = client.execute(apiRequest)) {
                String apiResult = EntityUtils.toString(apiResponse.getEntity());
                ObjectMapper mapper = new ObjectMapper();
                JsonNode root = mapper.readTree(apiResult);
                if (root.path("code").asInt() == 200) {
                    JsonNode data = root.path("data").get(0);
                    proxyIp = data.path("ip").asText();
                    proxyPort = data.path("port").asInt();
                    System.out.println("获取到代理IP：" + proxyIp + ":" + proxyPort);
                } else {
                    System.out.println("获取代理IP失败：" + root.path("msg").asText());
                    return;
                }
            }
        } catch (IOException e) {
            System.out.println("调用API接口异常：" + e.getMessage());
            return;
        }

        // 第二步：使用代理IP访问目标网站
        String targetUrl = "http://httpbin.org/ip";
        HttpHost proxy = new HttpHost(proxyIp, proxyPort, "http");
        RequestConfig config = RequestConfig.custom().setProxy(proxy).setConnectTimeout(10000).build();

        try (CloseableHttpClient client = HttpClients.custom().setDefaultRequestConfig(config).build()) {
            HttpGet targetRequest = new HttpGet(targetUrl);
            try (CloseableHttpResponse targetResponse = client.execute(targetRequest)) {
                String result = EntityUtils.toString(targetResponse.getEntity());
                System.out.println("目标网站返回的信息：" + result);
            }
        } catch (IOException e) {
            System.out.println("使用代理访问目标网站发生错误：" + e.getMessage());
        }
    }
}

常见问题与解决（QA）

Q1：代码返回错误，说代理连接失败或超时？
A1：首先检查你的网络是否能正常访问天启代理的API地址。确认你的授权方式是否正确（如果是白名单，请确保调用API的服务器公网IP已在后台添加）。短效IP有效期很短，获取后请立即使用，并做好异常处理，一旦失败立即重新获取新IP。

Q2：获取到的IP很快就被目标网站封了？
A2：天启代理支持“自动去重”功能，请在调用API时使用相关参数（如&distinct=true，具体参看文档），确保每次获取的IP不同。适当降低你的访问频率，模拟更真实的人类操作行为。

Q3：API返回的IP格式应该怎么拼接成程序能用的代理？
A3：API通常返回JSON格式，包含ip和port字段。对于HTTP代理，拼接格式为：http://ip:port；对于SOCKS5代理，格式通常为socks5://ip:port。具体使用方式需参照你所使用的编程语言网络库的要求。

Q4：如何管理大量IP并实现自动切换？
A4：建议在程序中设计一个“IP池”。首先通过API一次性获取多个IP存入池中。程序使用时从池中取出，使用失败则丢弃，并触发从API补充新IP到池中的逻辑。这样可以避免每次请求都调用一次API，提高效率。

-- 展开阅读全文 --