为什么你的API对接总是出问题？
很多开发者在刚接触代理IP的时候，往往会直接把IP和端口写死在代码里，结果跑没几次就报超时或者连接被拒绝。其实，专业的代理IP服务都是通过动态API接口来提取IP的。API不仅能自动轮换IP，还能根据你的业务需求过滤地区、设置协议。天启HTTP提供了非常丰富的API参数，支持自定义提取数量、返回格式等，但在实际对接中，如果没搞懂鉴权方式和提取逻辑，还是容易踩坑。今天咱们就从实战角度出发，用最白话的方式讲讲怎么用Java和PHP快速对接天启代理的API。
对接前的准备工作：搞懂授权方式
在写代码之前，有一步非常关键，那就是配置授权。天启HTTP为了保障账号资源安全，提供了两种主流的授权方式：终端IP授权和账号密码授权。
如果你是用自己公司的服务器跑业务，且出口IP是固定的，强烈建议用终端IP授权。你只需要在天启后台把你们服务器的公网IP填进去，提取IP时就不需要再带账号密码了，不仅更安全，而且调用速度更快。
如果你的业务跑在动态IP环境，或者多台机器轮换使用，那就选账号密码授权。在通过API获取到IP和端口后，使用代理发起请求时，需要在请求头里附带上账号密码进行鉴权。搞清楚这两点，对接就成功了一半。
Java语言对接天启代理API实战
Java在数据采集和企业级应用中用得非常多。对接天启API主要分两步：第一步通过API链接提取IP，第二步使用这个IP去请求目标网址。下面是一段可以直接拿来用的Java代码示例，我们用常用的HttpURLConnection来实现。
```java import java.io.BufferedReader; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.InetSocketAddress; import java.net.Proxy; import java.net.URL; public class TianqiProxyDemo { // 天启API提取链接，请在后台获取自己的专属API链接 private static final String API_URL = "https://api.tianqiip.com/getip?secret=你的密钥&num=1&protocol=http"; // 目标测试网址 private static final String TARGET_URL = "https://www.baidu.com"; public static void main(String[] args) { try { // 1. 调用天启API获取代理IP URL apiUrl = new URL(API_URL); HttpURLConnection apiConn = (HttpURLConnection) apiUrl.openConnection(); apiConn.setConnectTimeout(5000); apiConn.setReadTimeout(5000); BufferedReader reader = new BufferedReader(new InputStreamReader(apiConn.getInputStream())); StringBuilder response = new StringBuilder(); String line; while ((line = reader.readLine()) != null) { response.append(line); } reader.close(); // 假设返回格式为 ip:port （实际请根据天启后台设置的格式解析） String[] ipPort = response.toString().replace("", "").split(":"); if (ipPort.length == 2) { String proxyIp = ipPort[0]; int proxyPort = Integer.parseInt(ipPort[1]); System.out.println("获取到的代理IP: " + proxyIp + ":" + proxyPort); // 2. 使用代理IP访问目标网站 URL targetUrl = new URL(TARGET_URL); // 创建代理对象 Proxy proxy = new Proxy(Proxy.Type.HTTP, new InetSocketAddress(proxyIp, proxyPort)); HttpURLConnection targetConn = (HttpURLConnection) targetUrl.openConnection(proxy); targetConn.setConnectTimeout(10000); targetConn.setReadTimeout(10000); // 如果是账号密码授权，需要加上这行Header（Base64编码） // String auth = "用户名:密码"; // String encodedAuth = Base64.getEncoder().encodeToString(auth.getBytes()); // targetConn.setRequestProperty("Proxy-Authorization", "Basic " + encodedAuth); int responseCode = targetConn.getResponseCode(); System.out.println("目标网站返回状态码: " + responseCode); targetConn.disconnect(); } } catch (Exception e) { e.printStackTrace(); } } } ```这段代码逻辑很清晰：先请求天启的API拿到IP，然后把这个IP塞进Java的Proxy对象里，再去请求目标网站。天启HTTP的接口请求时间＜1秒，响应延迟≤10毫秒，所以你在设置超时时间的时候不用设得太长，这样能大大提高你程序的抓取效率。
PHP语言对接天启代理API实战
PHP写爬虫或者自动化脚本也很方便，尤其是用cURL扩展。下面演示一下在PHP中如何对接天启代理API，并且使用账号密码授权的方式去请求目标页面。
```php ```PHP的cURL非常强大，几行代码就能搞定代理转发。天启HTTP支持高并发调用，如果你用PHP跑多进程，直接在各个进程里独立调用API获取IP即可，系统采用分布式集群架构，完全不用担心并发时API接口会挂掉。
API返回参数与错误码排查指南
在对接过程中，难免会遇到API返回错误的情况。天启HTTP的API返回格式支持JSON或者文本，为了方便排错，建议大家在调试阶段先用JSON格式。下面列举几个常见的返回参数和含义：
| 返回字段/状态 | 含义说明 | 处理建议 |
|---|---|---|
| success | 请求成功，返回IP数据 | 直接解析data字段里的IP和端口使用 |
| error: 10001 | 密钥错误或未授权 | 检查后台API链接是否复制完整，检查终端IP白名单是否配置 |
| error: 10002 | 提取频率过快 | 天启支持高并发，但单次提取间隔需符合后台设置，建议加个延迟 |
| error: 10003 | 当日提取量已达上限 | 检查套餐额度是否用完，或联系客服扩容 |
常见问题QA模块
Q1: 获取到的IP一使用就报407 Proxy Authentication Required怎么办？
这是因为你使用了账号密码授权，但是代码里没有把账号密码传过去。参考上面PHP代码里的 CURLOPT_PROXYUSERPWD 或者Java代码里的 Proxy-Authorization 头。如果你嫌麻烦，可以直接在天启后台切换为终端IP授权，绑定你服务器的公网IP后就不用再传密码了。
Q2: 业务跑着跑着突然连不上代理了，但API还能提取到IP，是什么原因？
这种情况多半是IP过期了。天启HTTP提供不同生命周期的IP，比如3-30分钟短效动态IP。如果你提取了一个IP，过了它的有效期才去用，肯定连不上。解决办法是：随用随提，不要一次性提取几百个放在本地存着慢慢用，这样不仅浪费，还会导致失效。天启的接口响应时间＜1秒，完全来得及在每次请求前实时提取。
Q3: 我需要大量并发去请求，API接口会被限制吗？
天启HTTP是专门为企业级代理服务设计的，采用高性能服务器和分布式集群架构，支持高并发调用。但为了保证所有用户的系统稳定，后台对每个账号的每秒提取频率（QPS）会有一个合理阈值。如果你的业务确实需要极高的并发量，可以直接联系天启的724h专业技术客服，他们会一对一帮你调整并发参数，从容应对业务爆发性增长。
Q4: 怎么保证我每次拿到的IP是不重复的？
天启HTTP提供了资源自由去重功能，支持24小时自动去重和按需过滤重复资源。你在后台配置API的时候，直接勾选去重选项即可。系统会在底层自动过滤掉你最近提取过的IP，确保每次业务拿到的都是干净未重复的资源，这对于多账号防关联业务来说非常实用。
