天启API是什么？
简单来说，天启API就是一个让你能自动获取到大量代理IP地址的工具接口。想象一下，你需要很多个不同的IP地址来完成工作，如果一个个手动去找去设置，效率太低了。天启API就是帮你解决这个问题的，它像一个全自动的IP分发器，你只需要按照规则向它的接口地址发送一个请求，它就会快速返回一批新鲜、可用的代理IP给你，直接用在你的程序或软件里。
对于需要大量代理IP的业务场景，比如数据采集、价格监控、账号管理、测试验证等，使用API来提取IP是最高效、最稳定的方式。天启代理作为企业级服务商，其API的设计目标就是稳定、快速、易用，确保用户能无缝集成到自己的业务系统中，保证业务的连续性。
为什么需要代理IP提取API？
你可能会有疑问，我直接买代理IP不就行了吗，为什么非要通过API？这里的关键区别在于规模化和自动化。
如果你的业务只需要几个固定的IP，手动配置或许可行。但当业务量增大，需要成千上万个IP，并且要求IP不断更换以保持效果时，手动操作就完全不现实了。API提取方式的核心优势在于：
- 即时获取：随时随地按需获取IP，无需等待。
- 批量操作：一次请求可获取多个IP，极大提升效率。
- 无缝集成：直接将获取IP的步骤写入你的程序代码，实现全自动化运行。
- 资源新鲜度：API返回的通常是刚验证过可用性的IP，质量有保障。
天启代理的API特别强调了接口请求时间小于1秒，这意味着你的业务几乎不会被获取IP的步骤拖慢，保证了整体流程的顺畅。
天启代理IP提取API如何使用？
使用天启API提取代理IP，整个过程可以概括为三个步骤：获取授权、组装请求、处理返回结果。下面我们一步步来看。
第一步：获取调用凭证
在使用任何API之前，你都需要一个身份凭证，告诉API“我是谁，我有权使用”。天启代理主要提供两种授权方式：
- 终端IP授权：将你服务器的公网IP地址添加到白名单中。这种方式最简单，请求API时无需携带密码，适合在固定服务器上使用。
- 账号密码授权：在每次请求API时，在请求链接中附带你的用户名和密码。这种方式更灵活，适合在多个或不固定的设备上使用。
你可以在天启代理的用户后台找到你的API链接和相应的授权信息。
第二步：组装API请求链接
天启API的使用非常直观，基本上就是通过访问一个特定的URL链接来获取IP。一个标准的API请求链接通常包含以下参数：
| 参数名 | 说明 | 示例 |
|---|---|---|
| 协议 | 指定需要的代理协议，如HTTP或SOCKS5 | &type=http |
| 数量 | 一次想提取多少个IP | &num=5 |
| 存活时间 | 需要IP的稳定时长，如短效或长效 | &time=3 |
| 地区 | 指定IP的地理位置 | &city=北京 |
将这些参数拼接在你的基础API地址后面，就形成了一个完整的请求。例如，一个获取5个北京HTTP代理的链接可能长这样：http://api.tianqi.com/getip?type=http&num=5&city=北京（此为示例，实际链接请以天启代理后台为准）。
第三步：处理API返回结果
当你向组装好的链接发出请求后，天启API会以极快的速度（通常小于1秒）返回数据。返回格式一般是纯文本或JSON，非常便于程序处理。
常见的返回格式是每行一个IP，包含IP地址、端口、协议和过期时间等信息：
123.123.123.123:8080 124.124.124.124:8888 ...
你的程序在收到这个结果后，只需要按行读取，然后直接配置到你的网络请求工具中（如curl、requests库等）即可开始使用这些代理IP。
使用中的实用技巧与注意事项
要想用好API，光知道基本步骤还不够，一些细节技巧能让你事半功倍。
1. 合理设置提取数量： 不要一次性提取过多IP。虽然天启代理支持高并发，但根据你业务的实际消耗速度来设定数量更明智。比如你每分钟需要10个IP，那就设置每次取10个，并每分钟调用一次API，这样可以保证IP的新鲜度。
2. 善用去重功能： 天启API支持资源自由去重。如果你的业务对IP的唯一性要求很高，可以开启24小时自动去重模式，确保在指定时间内不会拿到重复的IP，避免因IP重复导致的操作失败。
3. 错误处理机制： 任何网络请求都可能偶尔失败。在你的代码中，一定要添加对API调用失败的处理逻辑。比如，如果请求超时或返回错误代码，应该进行重试或者使用备用方案，保证业务的鲁棒性。
4. 遵守使用规范： 合理使用代理IP资源，不要进行恶意请求或违反目标网站规则的操作。天启代理的企业级服务建立在合规基础上，共同维护良好的网络环境是持续稳定使用的前提。
常见问题QA
Q1: API调用有频率限制吗？
A: 天启代理的API基于其高性能服务器和分布式架构，能够支持较高的并发调用，以满足业务爆发性增长的需求。具体的频率限制会根据您选择的套餐有所不同，建议在用户后台或咨询技术支持了解详情。
Q2: 返回的IP突然不可用了怎么办？
A: 代理IP的网络环境是动态变化的，偶尔不可用是正常现象。天启代理的IP可用率保障在99%以上。建议您的程序内置IP有效性验证机制，一旦发现某个IP失效，立即丢弃并从API重新获取一个新的IP替换即可。这种“即用即弃”的策略是处理动态IP的最佳实践。
Q3: 我能指定某个城市或运营商的IP吗？
A: 可以的。这正是天启API的强大之处。通过设置请求参数，您可以精确指定需要IP的地理位置（天启代理覆盖全国200多个城市节点）甚至运营商。这为需要精准定位IP的业务提供了极大便利。
Q4: 技术支持响应快吗？
A: 天启代理提供724小时的专业技术客服支持，一对一答疑，旨在快速解决您在使用API或代理IP过程中遇到的任何技术问题，确保您的业务顺畅运行。
