代理ip的API接口返回格式：JSON中提取ip、端口、过期时间解析

一、先看看API返回的JSON长啥样

咱们在做爬虫或者自动化业务时，拿到代理IP的第一步往往是通过API接口提取。天启代理的API接口响应速度极快，接口请求时间通常在1秒以内。但接口返回的数据通常是一串JSON格式的文本，咱们得把里头的IP、端口和过期时间精准地抠出来，才能在代码里用得上。今天就来手把手教大家怎么搞定这个解析过程。

不管你用什么编程语言，调用天启代理的API后，拿到的基本都是一段JSON字符串。结构其实很简单，一般包含状态码、提示信息和核心数据区。为了方便说明，咱们看下面这个典型的返回示例：

{
    "code": 0,
    "msg": "success",
    "data": [
        {
            "ip": "123.124.125.126",
            "port": 8888,
            "expire_time": "2023-11-01 15:30:00"
        }
    ]
}

这段数据里，data字段里面的内容就是咱们要拿的干货。为了让大家看得更明白，我整理了一个字段说明表：

字段名称	含义说明	处理建议
code	请求状态码，0通常代表成功	解析前必须判断是否为成功状态
msg	提示信息	出错时用于排查问题
data	IP数据列表	可能包含多个IP，需遍历处理
ip	代理IP地址	直接提取使用
port	代理端口号	注意有些语言需要转为整型
expire_time	IP过期时间	需转为时间戳进行比对

二、手把手教你提取核心数据

看懂了结构，提取就简单了。咱们以Python为例，写几行代码就能搞定。核心思路就是先把JSON字符串转成字典对象，然后一层层往下找。

import json

 假设这是天启代理API返回的JSON字符串
api_response = '{"code": 0, "msg": "success", "data": [{"ip": "123.124.125.126", "port": 8888, "expire_time": "2023-11-01 15:30:00"}]}'

 将字符串解析为字典
result = json.loads(api_response)

 判断请求是否成功
if result.get("code") == 0:
    data_list = result.get("data")
    if data_list:
        for item in data_list:
            ip = item.get("ip")
            port = item.get("port")
            expire_time = item.get("expire_time")
            print(f"提取成功 -> IP: {ip}, 端口: {port}, 过期时间: {expire_time}")
    else:
        print("数据列表为空")
else:
    print(f"获取失败，原因：{result.get('msg')}")

这段代码里有个细节要注意，一定要先判断code是否为成功状态。因为如果请求太频繁或者账户状态不对，接口会返回错误信息，这时候data里面是没有IP的，直接去取会报错。天启代理采用高性能服务器和分布式集群架构，支持高并发调用，但大家在写代码时还是要把异常处理做好，保证业务不断线。

三、过期时间处理和IP可用性验证

提取出IP和端口后，别急着用，过期时间这个字段非常关键。天启代理提供了短效动态IP和长效静态IP，过期时间格式通常是字符串形式。如果你的业务需要长期维持会话，就得在代码里加个定时器，一旦发现当前时间接近过期时间，就赶紧调用API换新的IP。

处理过期时间，建议把它转成时间戳来比较：

from datetime import datetime

 假设提取到的过期时间
expire_time_str = "2023-11-01 15:30:00"
 转为时间戳
expire_timestamp = datetime.strptime(expire_time_str, "%Y-%m-%d %H:%M:%S").timestamp()
print(f"过期时间戳：{expire_timestamp}")

拿到IP后最好做个简单的连通性测试。天启代理采用全国自建机房纯净网络，IP可用率≥99％，响应延迟≤10毫秒。虽然质量过硬，但本地网络环境偶尔会有波动，做个验证能避免把失效IP扔进业务线程池里浪费资源。天启代理支持HTTP/HTTPS/SOCKS5三大协议，验证时选你业务实际用到的协议即可。