代理IP接口文档，到底是个啥？
第一次看到“API接口文档”这几个字，很多朋友可能会觉得头大，感觉是程序员才懂的东西。其实，你可以把它简单地理解为一份“产品说明书”。就像你新买了一个家电，要看说明书才知道怎么开机、怎么设置一样，接口文档就是告诉你，怎么从服务商那里“拿到”代理IP的说明书。
这份文档里会详细写明，你需要向哪个网址（API链接）发送请求，需要带上什么“暗号”（参数），然后对方会以什么样的格式把代理IP“快递”给你。对于天启代理这样的服务商，他们的文档通常会设计得非常清晰，即使你不是技术背景，静下心来读一读也能明白个大概。
拿到文档后，第一眼应该看哪里？
别急着从第一行开始逐字逐句地读，那样很容易被细节淹没。正确的打开方式是先抓住核心骨架：
1. 认证方式（Authorization）： 这是最关键的一步，相当于你家的门禁卡。文档会说明如何证明“你是你”，有权限获取IP。常见的方式有“终端IP授权”（白名单，只允许你指定的服务器IP来调用）和“账号密码授权”。天启代理支持这两种方式，能很好地保障你的账号资源安全。
2. 获取IP的API地址（Endpoint）： 这就是你要访问的那个“网址”。文档里会明确给出这个链接。
3. 请求参数（Parameters）： 你想获取什么样的代理IP？就在这里说清楚。比如，你需要哪个协议的IP（HTTP/HTTPS/SOCKS5）？需要多少个？IP的有效时长要多久？天启代理的API支持自定义这些参数，非常灵活。
4. 返回结果（Response）： 成功之后，服务器会返回一段信息给你。文档会告诉你这段信息的格式（通常是JSON或TXT），以及每个字段代表什么意思（比如IP地址、端口、过期时间等）。
新手如何一步步调用API？
理论说再多，不如动手试一次。我们以一个最简单的场景为例，演示如何调用天启代理的API获取一个IP。
第一步：准备你的“身份凭证”
根据文档的认证部分，设置好你的授权方式。如果使用账号密码授权，确保你的账号余额充足且状态正常。
第二步：拼接你的“请求”
天启代理的API设计得很直观。比如，一个获取动态短效IP的请求可能长这样：
https://api.tianqidaili.com/getip?num=1&type=json&protocol=http&time=10
我们来拆解一下这个链接：
- num=1： 我需要1个IP。
- type=json： 请用JSON格式返回结果给我，方便程序解析。
- protocol=http： 我需要HTTP协议的代理。
- time=10： 这个IP的有效期我希望是10分钟。
你看，是不是很像在点菜？告诉服务员你要什么，要多少。
第三步：发送请求并处理结果
你可以使用任何支持发送HTTP请求的工具来测试，比如Postman，或者直接写几行Python、PHP代码。发送上述请求后，你可能会收到这样一个JSON响应：
{"code":0, "data":[{"ip":"1.2.3.4","port":"5432","expire_time":"2024-01-01 12:00:00"}]}
这表示成功了（code为0），返回的IP地址是1.2.3.4，端口是5432，这个IP将在2024-01-01 12:00:00过期。接下来，你就可以用这个IP和端口去配置你的软件或程序了。
天启代理API的几个实用高级功能
除了基础获取IP，天启代理的API还提供了一些能极大提升效率的功能，了解它们能让你用得更顺手：
资源自由去重： 这个功能非常实用。比如你的业务需要连续获取多批IP，但又不希望前后两批IP有重复。天启代理的API支持多种去重模式，你可以设置一个时间窗口（比如24小时），系统会自动过滤掉在这个窗口内已经分配过的IP，确保你拿到的是新鲜未重复的资源。
按地区筛选： 天启代理在全国拥有200多个城市节点。如果你的业务需要特定地区的IP，比如只要上海或北京的IP，可以在请求参数里指定city或region，API就会返回对应地区的IP，精准满足业务需求。
高并发支持： 对于业务量大的用户，天启代理采用高性能服务器和分布式集群架构，API接口能够支持高并发调用。这意味着即使你的程序同时发出很多个获取IP的请求，系统也能快速稳定地响应，从容应对业务爆发性增长。
常见问题与解决方案（QA）
Q1: 调用API后返回错误代码，比如101，是什么意思？
A1: 每个错误代码在接口文档里都有明确的解释。比如101可能代表“账号余额不足”，201可能代表“请求参数错误”。遇到错误不要慌，第一件事就是去查文档里的“错误代码表”，它能最快地帮你定位问题。
Q2: 获取到的IP连接不上或者速度慢怎么办？
A2: 任何代理服务都无法保证100%的绝对可用率。天启代理的IP可用率≥99%，已经非常高。如果偶尔遇到不可用的IP，标准的做法是建立一个“IP池”，并实现一个简单的验证机制：获取到IP后，先用一个简单的请求（比如访问百度）测试一下其连通性和速度，将不合格的IP剔除，确保池子里的IP都是可用的。天启代理也提供了IP有效期信息，及时更换过期IP是关键。
Q3: 我是完全的小白，不会写代码，还能用吗？
A3: 当然可以。很多代理IP客户端软件支持直接填入天启代理的API链接，软件会自动帮你调用API获取IP并管理IP池。你只需要在软件里做好配置即可，无需自己编写调用代码。天启代理的专业技术客服也会724小时提供技术支持，协助你解决接入过程中遇到的任何问题。
