API 提取生成

参数配置
全部省份
HTTP(S)/SOCKS5 协议

提取数量

数量：
提示：可提取 1-200 个代理IP

API请求参数

参数名
类型
必填
说明
key
String
是*
用户密钥（key）
package_type
String
是
套餐类型：time(包时套餐)/static(静态套餐)/balance(余额套餐)
num
Int
否
提取数量，范围1-200，默认为1
time
Int
否
IP时效：[1=5分钟, 2=15分钟, 3=25分钟, 4=3小时]；静态套餐[1=7天, 2=1个月]，默认为1
mode
Int
否
协议类型：1(HTTP)/3(SOCKS5)，默认为1
type
Int
否
返回格式：1(TXT)/2(JSON)，默认为2
province
String
否
省份筛选，留空则不限制
city
String
否
城市筛选，留空则不限制
quchong
Int
否
IP去重：1(自动去重)，默认为1

返回结果示例

成功响应 (JSON格式)

{
  "code": 200,
  "success": true,
  "message": "提取成功",
  "data": [
    {
      "ip": "123.456.789.012",
      "port": 8080,
      "city": "北京",
      "isp": "电信",
      "expire_time": "2024-12-31 12:00:00"
    }
  ]
}

成功响应 (TXT格式)

123.456.789.012:8080
234.567.890.123:8080

注：SOCKS5格式会在每行前添加 socks5:// 前缀

错误响应

{
  "code": 400,
  "success": false,
  "message": "用户验证失败",
  "data": []
}

返回字段说明

字段名
类型
说明
code
Int
状态码，200表示成功
success
Boolean
请求是否成功
message
String
提示信息
data
Array
IP数据列表
ip
String
IP地址
port
Int
端口号
province
String
省份（province）
city
String
城市（city）
isp
String
运营商（isp）
expire_time
String
过期时间（仅JSON格式）

白名单接口

查询白名单接口

https://www.mayihttp.com/auth.php?key={您的KEY}&action=whitelist_list
返回示例：
{
  "code": 200,
  "success": true,
  "message": "查询成功",
  "data": {
    "total": 2,
    "limit": 10,
    "list": [
      {
        "ip": "192.168.1.1",
        "created_at": "2024-01-15 10:30:00"
      },
      {
        "ip": "10.0.0.1",
        "created_at": "2024-01-16 14:20:00"
      }
    ]
  }
}

添加白名单接口

https://www.mayihttp.com/auth.php?key={您的KEY}&action=whitelist_add&ip=192.168.1.1
返回示例：
{
  "code": 200,
  "success": true,
  "message": "白名单添加成功",
  "data": {
    "ip": "192.168.1.1"
  }
}

删除白名单接口

https://www.mayihttp.com/auth.php?key={您的KEY}&action=whitelist_delete&ip=192.168.1.1
返回示例：
{
  "code": 200,
  "success": true,
  "message": "白名单删除成功"
}

接入代码示例

# Python HTTP/HTTPS代理示例
import requests

# HTTP/HTTPS代理服务器配置
proxies = {
    'http': 'http://123.456.789.012:8080',
    'https': 'http://123.456.789.012:8080'
}

try:
    # 发送请求
    response = requests.get('http://httpbin.org/ip', proxies=proxies, timeout=10)
    print(f"响应内容: {response.text}")
    print(f"状态码: {response.status_code}")
except requests.exceptions.RequestException as e:
    print(f"请求失败: {e}")

安全稳定

企业级安全防护，99.9%可用性保证

极速响应

毫秒级响应速度，API调用无延迟

灵活接入

多语言SDK支持，快速集成使用

技术支持

7×24小时技术支持，专业团队服务