IP列表接口
开发中
POST
http://36.134.39.3:3367/api/v1/ips/extract
● 扣费：每次按提取数量扣减绑定业务 token 的额度（ credits）， 成功后生效；失败自动回滚。
● 鉴权：使用业务 token 的 Basic 认证。
● 返回：统—结构
请求参数
Header 参数
Body 参数application/json
示例
{
"city_id":"130200",
"qty":5
}返回响应
🟢200成功
application/json
Body
示例
{
"code": 0,
"data": {
"count": 5,
"items": [
{
"city": "河北-唐山",
"expire_at": 1763713032,
"ip": "106.119.251.149",
"ip_port": "106.119.251.149:40016",
"out_ip": "",
"port": 40016,
"source": "shuyan",
"tags": []
},
{
"city": "河北-唐山",
"expire_at": 1763713032,
"ip": "106.119.248.216",
"ip_port": "106.119.248.216:40006",
"out_ip": "",
"port": 40006,
"source": "shuyan",
"tags": []
},
{
"city": "河北-唐山",
"expire_at": 1763713032,
"ip": "106.119.248.25",
"ip_port": "106.119.248.25:40011",
"out_ip": "",
"port": 40011,
"source": "shuyan",
"tags": []
},
{
"city": "河北-唐山",
"expire_at": 1763713032,
"ip": "106.119.251.179",
"ip_port": "106.119.251.179:40018",
"out_ip": "",
"port": 40018,
"source": "shuyan",
"tags": []
},
{
"city": "河北-唐山",
"expire_at": 1763713032,
"ip": "106.119.251.177",
"ip_port": "106.119.251.177:40003",
"out_ip": "",
"port": 40003,
"source": "shuyan",
"tags": []
}
],
"request": {
"city_id": "130200",
"qty": 5
},
"source": "shuyan",
"token": {
"allocated_total": 116,
"credits_remain": 9980,
"username": "test5-1"
}
},
"message": "success"
}🟠400额度不足
🟠401没有权限
🟠409请求有误