API获取代理IP：Python/Java/C++多语言调用代码示例

代理IP与API调用的基础认知

在网络数据交互中，直接使用本地IP进行高频或特定操作，有时会遇到限制。代理IP作为一种中转服务，能够替代用户的真实IP地址发起请求，从而更加顺畅地完成业务。对于开发者而言，通过API接口获取代理IP并将其集成到代码中，是实现自动化业务流的关键一步。天启代理提供的API接口设计简洁，返回格式清晰，无论是提取IP还是查看剩余IP数量，都能通过简单的HTTP请求完成，极大降低了接入门槛。

天启代理API接口详解

在编写代码之前，我们需要先了解天启代理API的基本信息。通常，一个完整的获取代理IP的API请求需要包含以下几个要素：

请求URL： 这是天启代理提供给你的专属接口地址。

请求参数： 通过参数来控制获取IP的数量、协议、格式等。常见的参数如下表所示：

参数名	含义	示例值
method	获取IP的方式，如按数量获取	get
num	一次性获取IP的数量	5
protocol	代理协议，如http或socks5	http
format	返回数据格式，如json或text	json

认证信息： 为了保障用户资源安全，天启代理支持终端IP授权和账号密码授权两种方式。在请求时，你需要将认证信息（如API Key）作为参数一同提交。

一个典型的API返回结果（JSON格式）可能长这样：

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "ip": "1.2.3.4",
      "port": 8080,
      "expire_time": "2024-01-01 23:59:59"
    },
    ...
  ]
}

天启代理的API具有响应延迟≤10毫秒，接口请求时间＜1秒的特点，这意味着你的程序无需长时间等待，就能快速获得可用的代理IP，保障了业务的高效运行。

Python调用示例：快速上手

Python凭借其简洁的语法和丰富的库，是进行网络请求和数据处理的首选语言之一。下面是一个使用`requests`库调用天启代理API的完整示例。

import requests

 天启代理API配置
api_url = "https://your-tianqi-api.com/getip"   请替换为天启代理提供的真实API地址
params = {
    "key": "YOUR_API_KEY",   你的天启代理API密钥
    "num": 5,               获取5个IP
    "protocol": "http",      协议类型
    "format": "json"         返回格式
}

try:
    response = requests.get(api_url, params=params)
    result = response.json()

    if result.get("code") == 0:   判断请求是否成功
        proxy_list = result["data"]
        for proxy in proxy_list:
            ip_port = f"{proxy['ip']}:{proxy['port']}"
            print(f"获取到代理IP：{ip_port}，过期时间：{proxy['expire_time']}")

             示例：使用该代理IP发起一个请求
            proxies = {
                "http": f"http://{ip_port}",
                "https": f"http://{ip_port}"
            }
            test_response = requests.get("http://httpbin.org/ip", proxies=proxies, timeout=5)
            print(f"测试请求结果：{test_response.text}")

    else:
        print(f"获取IP失败：{result.get('msg')}")

except requests.exceptions.RequestException as e:
    print(f"请求过程中出现错误：{e}")

这段代码清晰地展示了从天启代理获取IP到实际使用的全过程。天启代理全国200+城市节点的优势在这里得以体现，你可以通过API参数指定地区，获取到分布广泛的IP资源，满足业务对IP地理位置的多样性需求。

Java调用示例：稳健之选

在企业级开发中，Java以其稳定性和强大的并发处理能力被广泛使用。以下是使用Java原生`HttpURLConnection`及`OkHttp`客户端调用天启代理API的示例。

使用 HttpURLConnection：

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;

public class TianQiProxyDemo {
    public static void main(String[] args) {
        String apiUrl = "https://your-tianqi-api.com/getip?key=YOUR_API_KEY&num=3&format=json";

        try {
            URL url = new URL(apiUrl);
            HttpURLConnection conn = (HttpURLConnection) url.openConnection();
            conn.setRequestMethod("GET");

            BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
            String inputLine;
            StringBuffer content = new StringBuffer();
            while ((inputLine = in.readLine()) != null) {
                content.append(inputLine);
            }
            in.close();
            conn.disconnect();

            // 此处应使用JSON库（如Jackson、Gson）解析content.toString()，这里为演示直接输出
            System.out.println("API响应: " + content.toString());

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

使用 OkHttp（更现代的方式）：

import okhttp3.;

public class TianQiProxyWithOkHttp {
    public static void main(String[] args) {
        OkHttpClient client = new OkHttpClient();

        HttpUrl.Builder urlBuilder = HttpUrl.parse("https://your-tianqi-api.com/getip").newBuilder();
        urlBuilder.addQueryParameter("key", "YOUR_API_KEY");
        urlBuilder.addQueryParameter("num", "3");
        urlBuilder.addQueryParameter("format", "json");
        String url = urlBuilder.build().toString();

        Request request = new Request.Builder().url(url).build();

        try (Response response = client.newCall(request).execute()) {
            if (response.isSuccessful()) {
                String responseBody = response.body().string();
                System.out.println("API响应: " + responseBody);
                // 解析JSON，获取代理IP列表...
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

天启代理的企业级代理服务采用高性能服务器和分布式集群架构，能够很好地支持Java应用的高并发调用，确保在大规模业务场景下IP获取的稳定与快速。

C++调用示例：性能追求

对于追求极致性能的C++开发者，可以使用`libcurl`这个强大的库来处理HTTP请求。以下是一个简单的示例。

include 
include 
include 

// 用于存储HTTP响应数据的回调函数
static size_t WriteCallback(void contents, size_t size, size_t nmemb, void userp) {
    ((std::string)userp)->append((char)contents, size  nmemb);
    return size  nmemb;
}

int main() {
    CURL curl;
    CURLcode res;
    std::string readBuffer;

    curl_global_init(CURL_GLOBAL_DEFAULT);
    curl = curl_easy_init();

    if (curl) {
        // 构建请求URL
        std::string url = "https://your-tianqi-api.com/getip?key=YOUR_API_KEY&num=2&format=json";
        curl_easy_setopt(curl, CURLOPT_URL, url.c_str());
        curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, WriteCallback);
        curl_easy_setopt(curl, CURLOPT_WRITEDATA, &readBuffer);

        res = curl_easy_perform(curl); // 执行请求

        if (res != CURLE_OK) {
            std::cerr << "curl_easy_perform() failed: " << curl_easy_strerror(res) << std::endl;
        } else {
            std::cout << "API响应: " << readBuffer << std::endl;
            // 使用如nlohmann/json等库来解析JSON字符串...
        }

        curl_easy_cleanup(curl);
    }

    curl_global_cleanup();
    return 0;
}

编译时需要链接libcurl库（例如：`g++ -o proxy_demo proxy_demo.cpp -lcurl`）。天启代理自建机房纯净网络，IP可用率高且稳定，这对于需要长时间稳定运行的C++后台服务至关重要。