API代理IP怎么对接？多语言代码示例与接口调用的完整教程

API代理IP对接，到底是个啥？

简单来说，你有一个程序（比如爬虫、数据采集工具、或者需要模拟不同地区用户的软件），这个程序需要访问某个网站。但如果你直接用自己电脑的网络去访问，可能会因为访问太频繁被网站限制，或者因为地区问题无法获取数据。这时候，API代理IP服务就派上用场了。

它的工作流程是这样的：你的程序不再直接去访问目标网站，而是先向代理服务商（比如天启代理）的API接口发一个请求，说：“给我一个能用的代理IP地址和端口。” 天启代理的服务器会立刻从它庞大的IP池里，挑出一个新鲜可用的IP信息（包括IP、端口、用户名、密码等）返回给你的程序。你的程序拿到这个信息后，就可以用它作为“跳板”，通过这个新的IP地址去访问目标网站了。整个过程通过API自动完成，高效便捷。

为什么选择天启代理的API接口？

市面上代理服务不少，但对接体验和稳定性天差地别。天启代理的API接口设计，核心就是为了让开发者省心、高效、稳定。

它的响应速度极快，接口请求时间通常在1秒内完成，这意味着你的业务几乎无需等待。它提供的IP可用率高达99%以上，并且响应延迟极低，确保你的程序能流畅运行，不会总在“等待连接”或“处理无效IP”上浪费时间。天启代理支持HTTP、HTTPS、SOCKS5三种主流协议，无论你的业务场景需要哪种，都能无缝对接。

更重要的是，它的API功能非常灵活。你可以通过参数控制提取IP的数量、IP所在的地区（全国200多个城市节点）、IP的存活时长（从几分钟到几十小时不等），甚至设置自动去重，确保每次获取的IP都是新鲜的，这对于需要大规模数据采集的业务至关重要。

手把手教你调用API获取代理IP

对接天启代理的API，其实比你想象的要简单。整个过程可以概括为三个步骤：注册获取授权、调用提取接口、在程序中使用代理。

第一步：获取授权信息
在天启代理官网注册账号并充值后，进入后台管理界面。你会找到两种主要的授权方式：终端IP授权（将你服务器的公网IP添加到白名单）或账号密码授权（每个API请求都附带用户名和密码进行验证）。选择一种适合你业务安全需求的即可。你会获得一个专属的API提取链接（Endpoint）。

第二步：调用API提取接口
这是核心步骤。你只需要向天启代理提供的API链接发送一个HTTP GET请求。你可以在URL后面添加各种参数来定制你需要的IP。一个典型的请求URL可能长这样：

https://api.tianqiip.com/getip?key=你的API密钥&num=5&protocol=http&city=北京&format=json

这个请求的意思是：使用我的密钥，请求5个位于北京地区的HTTP协议代理IP，以JSON格式返回给我。

第三步：集成到你的程序中
API会返回类似下面的JSON数据。你只需要在你的程序中解析这个结果，取出IP、端口、用户名（如果有）、密码（如果有）等信息，然后将其设置为你的网络请求的代理即可。

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "ip": "1.2.3.4",
      "port": 1234,
      "expire_time": "2023-10-01 12:00:00",
      "city": "北京",
      "isp": "电信"
    }
    // ... 更多IP
  ]
}

多语言代码实战示例

理论说完了，来看点实际的。下面用几种最常见的编程语言，演示如何调用天启代理API并实际使用获取到的代理IP。

Python示例

import requests

 1. 调用天启代理API获取IP列表
api_url = "https://api.tianqiip.com/getip?key=YOUR_API_KEY&num=1&format=json"
resp = requests.get(api_url).json()
if resp['code'] == 0:
    proxy_info = resp['data'][0]
    proxy = f"http://{proxy_info['ip']}:{proxy_info['port']}"
     如果使用用户名密码授权，格式为：http://user:pass@ip:port
     proxy = f"http://{USERNAME}:{PASSWORD}@{proxy_info['ip']}:{proxy_info['port']}"

     2. 使用获取的代理去访问目标网站
    target_url = "http://httpbin.org/ip"
    proxies = {
        'http': proxy,
        'https': proxy
    }
    try:
        response = requests.get(target_url, proxies=proxies, timeout=10)
        print("使用代理后的IP:", response.text)
    except Exception as e:
        print("请求失败:", e)
else:
    print("获取代理失败:", resp['msg'])

Java示例 (使用HttpClient)

import org.apache.http.HttpHost;
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;

public class TianQiProxyDemo {
    public static void main(String[] args) {
        String apiKey = "YOUR_API_KEY";
        String apiUrl = "https://api.tianqiip.com/getip?key=" + apiKey + "&num=1&format=json";

        try (CloseableHttpClient client = HttpClients.createDefault()) {
            // 1. 获取代理IP
            HttpGet getProxy = new HttpGet(apiUrl);
            CloseableHttpResponse apiResponse = client.execute(getProxy);
            String apiResult = EntityUtils.toString(apiResponse.getEntity());
            apiResponse.close();

            ObjectMapper mapper = new ObjectMapper();
            JsonNode root = mapper.readTree(apiResult);
            if (root.get("code").asInt() == 0) {
                JsonNode data = root.get("data").get(0);
                String proxyIp = data.get("ip").asText();
                int proxyPort = data.get("port").asInt();

                // 2. 使用代理访问目标
                HttpHost proxy = new HttpHost(proxyIp, proxyPort, "http");
                CloseableHttpClient proxyClient = HttpClients.custom()
                        .setProxy(proxy)
                        .build();

                HttpGet request = new HttpGet("http://httpbin.org/ip");
                CloseableHttpResponse targetResponse = proxyClient.execute(request);
                System.out.println("使用代理后的响应：" + EntityUtils.toString(targetResponse.getEntity()));
                targetResponse.close();
                proxyClient.close();
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Node.js示例

const axios = require('axios');
const { HttpsProxyAgent } = require('https-proxy-agent');

async function useTianQiProxy() {
    const apiKey = 'YOUR_API_KEY';
    const apiUrl = `https://api.tianqiip.com/getip?key=${apiKey}&num=1&format=json`;

    try {
        // 1. 获取代理IP
        const apiRes = await axios.get(apiUrl);
        if (apiRes.data.code === 0) {
            const proxy = apiRes.data.data[0];
            const proxyUrl = `http://${proxy.ip}:${proxy.port}`;
            const agent = new HttpsProxyAgent(proxyUrl); // 支持HTTP/HTTPS

            // 2. 使用代理访问目标
            const targetUrl = 'http://httpbin.org/ip';
            const response = await axios.get(targetUrl, {
                httpsAgent: agent,
                httpAgent: agent,
                timeout: 10000
            });
            console.log('使用代理后的结果：', response.data);
        } else {
            console.log('获取代理失败：', apiRes.data.msg);
        }
    } catch (error) {
        console.error('出错了：', error.message);
    }
}

useTianQiProxy();

常见问题与解答 (QA)

Q1：API调用返回错误代码，比如“10001”，是什么意思？
A1：每个错误代码都有特定含义。“10001”通常代表“授权失败”，请检查你的API密钥是否正确，或者检查你的终端IP是否已添加到白名单（如果使用的是终端IP授权模式）。天启代理后台的API文档或技术客服会提供完整的错误代码列表和解决方案。

Q2：获取到的代理IP用不了，很快就失效了怎么办？
A2：代理IP有其生命周期，尤其是动态IP。天启代理提供不同存活时长的IP，从几分钟到几十小时不等。如果你的业务需要长时间连接，请选择长效静态IP套餐。建议在你的程序中加入异常重试机制：当使用某个代理IP请求失败时，自动丢弃它并立即从天启代理API重新获取一个新IP，这样能最大程度保证业务的连续性。

Q3：如何保证高并发场景下的代理IP供应？
A3：天启代理的API接口和后台集群架构就是为高并发设计的。你可以在单次API请求中提取多个IP（通过num参数），建立一个本地IP池，减少频繁调用API的次数。天启代理的服务支持分布式调用，你可以用多个子账号或从不同服务器同时调用API，负载均衡。他们的技术客服也能针对你的具体业务量，给出最优的对接方案。

Q4：除了提取IP，API还能做什么？
A4：天启代理的API功能很丰富。除了最核心的提取IP，你还可以通过API查询IP余额、获取IP白名单、设置自动IP替换（去重）规则等。这意味着你几乎可以通过API管理所有代理相关操作，非常适合自动化运维和集成到内部系统中。