正文

代理IP获取API开发指南：接口调用参数说明与多语言代码示例

天启代理
天启代理 V管理员 /7 阅读
0625

API接口调用参数详解

调用代理IP的API接口，关键在于理解并正确设置参数。以天启代理的API为例，其核心设计追求简洁高效，开发者通常只需关注几个核心参数即可快速获取到可用的IP。下面我们来逐一拆解这些参数的作用。

代理IP获取API开发指南：接口调用参数说明与多语言代码示例

最基础的参数是数量（num），它决定了单次API调用返回的IP数量。根据业务并发需求，你可以灵活设置，比如数据采集需要10个IP，就设置num=10。其次是协议类型（protocol），天启代理支持HTTP、HTTPS和SOCKS5三种协议，你需要根据目标网站的访问协议来匹配，例如访问普通网页用HTTP，访问加密链接用HTTPS，而一些需要更高匿名性的场景则可以选择SOCKS5。

另一个重要参数是返回格式（format）。为了方便不同技术栈的开发者集成，API通常支持JSON、TXT等格式。JSON格式结构清晰，适合编程语言解析；TXT格式则简单直接，每行一个IP，便于脚本直接使用。地区（region）参数允许你指定IP的地理位置，天启代理拥有全国200多个城市的节点，你可以通过此参数获取特定地区的IP，这对于需要模拟本地访问的场景非常有用。

多语言调用代码示例

理解了参数，接下来就是动手调用。这里提供几个主流语言的调用示例，帮助你快速上手。请注意，以下示例中的API地址、授权密钥（key）等均为示意，你需要替换为从天启代理控制台获取的真实信息。

Python 示例：

import requests

def get_proxy_ips():
    api_url = "https://api.tianqiip.com/getip"
    params = {
        'key': '你的授权密钥',
        'num': 5,           获取5个IP
        'protocol': 'http',  协议类型
        'format': 'json',    返回json格式
        'region': '北京'     指定北京地区IP
    }
    try:
        response = requests.get(api_url, params=params, timeout=5)
        data = response.json()
        if data['code'] == 200:
            ip_list = data['data']
            for ip_info in ip_list:
                print(f"IP: {ip_info['ip']}:{ip_info['port']}")
        else:
            print(f"获取失败: {data['msg']}")
    except Exception as e:
        print(f"请求异常: {e}")

if __name__ == '__main__':
    get_proxy_ips()

Java 示例：

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

public class TianqiProxy {
    public static void main(String[] args) {
        String apiUrl = "https://api.tianqiip.com/getip?key=你的授权密钥&num=3&protocol=https&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;
            StringBuilder content = new StringBuilder();
            while ((inputLine = in.readLine()) != null) {
                content.append(inputLine);
            }
            in.close();
            System.out.println("获取的IP信息: " + content.toString());
            conn.disconnect();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Node.js 示例：

const https = require('https');

const options = {
  hostname: 'api.tianqiip.com',
  path: '/getip?key=你的授权密钥&num=2&protocol=socks5&format=txt',
  method: 'GET'
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => {
    data += chunk;
  });
  res.on('end', () => {
    console.log('获取的IP列表（每行一个）:');
    console.log(data);
  });
});

req.on('error', (e) => {
  console.error(`请求遇到问题: ${e.message}`);
});
req.end();

集成与使用中的常见问题（QA）

Q1: 调用API返回错误码，如何排查？
A1：首先查看返回信息中的具体错误码和提示。常见问题有：授权密钥（key）错误或已过期；请求频率超过套餐限制；请求参数格式或值不正确（如协议类型填写错误）。建议先核对文档中的参数说明，并确保账户状态正常。

Q2: 获取到的IP连接超时或无法使用怎么办？
A2：代理IP在网络环境中存在一定的时效性。天启代理的IP具有高可用率，但如果遇到个别IP不可用，建议在程序中加入重试机制，即自动丢弃当前IP并重新获取一个。确保你使用的协议（HTTP/HTTPS）与目标网站匹配。

Q3: 如何在爬虫或业务中自动？
A3：核心思路是定时或按需调用API获取新的IP池，并在请求时随机或顺序选用。可以创建一个IP管理模块，当某个IP使用失败达到一定次数，或达到预设的使用时长后，将其从可用池中移除，并调用天启代理的API补充新的IP。

Q4: 如何保证代理请求的稳定性？
A4：除了选择像天启代理这样提供高可用率、低延迟IP的服务商外，在代码层面应做好异常处理（如设置连接超时和读取超时）、实现失败重试逻辑，并考虑使用连接池来管理代理IP连接，避免频繁建立和断开连接的开销。

选择可靠服务商的关键点

开发工作离不开稳定可靠的基础服务。在选择代理IP服务商时，不能只看价格，更需要关注其技术实力和资源质量，这直接关系到你后续开发的效率和系统的稳定性。

首先看资源质量与网络。优质的服务商应拥有运营商正规授权的资源，像天启代理这样自建全国机房节点，能确保IP资源的纯净与稳定，从源头上减少IP被封禁或污染的风险，其高达99%的可用率和极低的延迟是业务流畅运行的保障。

其次看技术能力与接口。API的响应速度、接口设计的易用性以及是否支持高并发调用，都体现了服务商的技术功底。天启代理的API请求时间可控制在1秒内，并支持多种去重模式和授权方式，这为应对复杂业务场景提供了灵活性。

最后是服务支持。技术问题随时可能出现，能否获得专业、及时的技术支持至关重要。拥有专业技术客服团队，能够一对一快速响应和解决问题的服务商，能为你节省大量排查故障的时间，让开发更聚焦于核心业务逻辑。

-- 展开阅读全文 --