🔥 火龙代理IP API 使用说明文档

最新版本登录网站查看

http://www.huolongip.cn/UserCenter/API_Documentation

完整的代理IP接口文档 - 快速上手，简单易用

📋 目录导航

• 接口概览

• 提取代理IP API

• 白名单管理 API

• 查询剩余量 API

• 签名计算示例

• 性能说明

• 注意事项

• 技术支持

📌 接口概览

基础URL

复制

http://API域名:端口/Tools/proxyIP.ashx

接口列表

🎯 提取代理IP API

接口地址

复制

GET /Tools/proxyIP.ashx?action=GetIP

请求参数说明

请求示例

1. 基础请求（JSON格式）

复制

GET /Tools/proxyIP.ashx?action=GetIP&ordernumber=订单号&sign={sign}&qty=20&Split=JSON

2. 带地区和运营商筛选

复制

GET /Tools/proxyIP.ashx?action=GetIP&ordernumber=订单号&sign={sign}&qty=10&Address=广东省&isp=电信&Split=JSON

3. 提取时提交白名单

复制

GET /Tools/proxyIP.ashx?action=GetIP&ordernumber=订单号&sign={sign}&qty=10&Whitelist=您的外网IP&Split=JSON

响应格式说明

JSON格式（Split=JSON）

复制

{
  "Code": 0,
  "Success": true,
  "Message": "成功",
  "LeftTime": "86400",
  "QTY": 2,
  "LeftIp": "4980",
  "Data": [
    {
      "Ip": "192.168.1.1",
      "Port": 8080,
      "ISP": "电信",
      "FullAddress": "广东省深圳市",
      "Remarks": "",
      "IPPassword": null,
      "IPUserName": null,
      "IPlifetime": "2024-12-31 23:59:59"
    }
  ]
}

JSON2格式（Split=JSON2）

复制

{
  "status": 200,
  "msg": "成功",
  "leftTime": "86400",
  "leftIp": "4980",
  "QTY": 2,
  "data": [
    {
      "ip": "192.168.1.1",
      "port": "8080",
      "city": "广东省深圳市",
      "isp": "电信",
      "expire": "2024/12/31 23:59:59",
      "outip": ""
    }
  ]
}

JSON3格式（Split=JSON3）

复制

{
  "success": true,
  "data": [
    {
      "ip": "192.168.1.1",
      "port": 8080,
      "country": "中国",
      "fullAddress": "广东省深圳市",
      "proxyType": "HTTP",
      "speed": 100,
      "anonymousType": "高匿",
      "expireTime": "2024-12-31 23:59:59",
      "userName": "",
      "password": "",
      "expiresIn": 86400
    }
  ]
}

JSON4格式（Split=JSON4）

复制

{
  "success": true,
  "count": 2,
  "list": [
    {
      "IP": "192.168.1.1",
      "Port": 8080,
      "ExpireTime": "2024-12-31 23:59:59",
      "Area": "广东省深圳市",
      "Auth": "false"
    }
  ]
}

文本格式（Split=\n）

复制

192.168.1.1:8080
192.168.1.2:8080

文本格式带认证（AuthMode=1）

复制

192.168.1.1:8080,username,password
192.168.1.2:8080,username,password

错误响应说明

完整错误代码表

常见错误响应示例

成功响应（JSON格式）

复制

{
  "Code": 0,
  "Success": true,
  "Message": "成功",
  "LeftTime": "86400",
  "QTY": 2,
  "LeftIp": "4980",
  "Data": [...]
}

IP不足或筛选条件过多

复制

{
  "Code": 304,
  "Success": false,
  "Message": "IP不足或者筛选条件过多",
  "LeftTime": "0",
  "QTY": 0,
  "LeftIp": "",
  "Data": []
}

订单不存在

复制

{
  "Code": 802,
  "Success": false,
  "Message": "订单不存在",
  "LeftTime": "0",
  "QTY": 0,
  "LeftIp": "",
  "Data": []
}

订单已过期

复制

{
  "Code": 801,
  "Success": false,
  "Message": "订单过期",
  "LeftTime": "0",
  "QTY": 0,
  "LeftIp": "",
  "Data": []
}

数量用完

复制

{
  "Code": 306,
  "Success": false,
  "Message": "数量用完",
  "LeftTime": "0",
  "QTY": 0,
  "LeftIp": "",
  "Data": []
}

请求过于频繁

复制

{
  "Code": 429,
  "Success": false,
  "Message": "请求过于频繁，请稍后重试",
  "LeftTime": "60",
  "QTY": 0,
  "LeftIp": "",
  "Data": []
}

� 白名单管理 API

📌 签名说明：根据当前后端代码，提取 IP、添加白名单、删除白名单、读取白名单、查询剩余量这 5 个 API 都需要校验 sign。

请求参数

添加白名单示例

复制

GET /Tools/proxyIP.ashx?action=AddWhitelist&ordernumber=订单号&sign={sign}&qty=1&IP=120.239.199.175

删除白名单示例

复制

GET /Tools/proxyIP.ashx?action=DELWHITEIP&ordernumber=订单号&sign={sign}&qty=1&IP=192.168.1.1

读取白名单示例

复制

GET /Tools/proxyIP.ashx?action=Getwhitelist&ordernumber=订单号&sign={sign}&qty=1

📌 保持活跃：系统会检测不活动的白名单并自动删除，如需保持白名单长期有效，建议约每 3 分钟提交一次。

📊 查询剩余量 API

📌 签名说明：查询剩余量接口同样需要 sign，计算方式为 md5(ordernumber + 签名密钥)。

请求示例

复制

GET /Tools/proxyIP.ashx?action=GetINF&ordernumber=订单号&sign={sign}&qty=1

参数说明

🔐 签名计算示例

JavaScript

复制

const crypto = require('crypto');
const ordernumber = '订单号';
const signKey = '你的签名密钥';
const sign = crypto.createHash('md5').update(ordernumber + signKey).digest('hex');
console.log(sign);

Python

复制

import hashlib
ordernumber = '订单号'
sign_key = '你的签名密钥'
sign = hashlib.md5((ordernumber + sign_key).encode('utf-8')).hexdigest()
print(sign)

PHP

复制

$ordernumber = '订单号';
$signKey = '你的签名密钥';
$sign = md5($ordernumber . $signKey);
echo $sign;

⚡ 性能说明

1. 请求频率限制：每个订单号每分钟最多1500次请求,超限制防火墙拉黑

2. 请求超时：10秒超时

3. 响应快：提取IP响应小于100ms

4. 支持多机器：支持多机器同时提取

⚠️ 注意事项

📌 签名必需：提取 IP、添加白名单、删除白名单、读取白名单、查询剩余量这 5 个 API 都需要正确的 sign 参数

📌 订单验证：确保订单有效且未过期

• IP池选择：根据实际需求选择合适的IP池

• 缓存使用：不限量套餐缓存输出，实现一直能提取到IP

• 错误处理：遇到304错误时请稍后重试或调整筛选条件

💬 技术支持

如有问题请联系：QQ 374417086

📄 文档版本：v1.0   |   📅 更新日期：2024年

       ← 返回API生成