微信客服
微信客服二维码
微信客服
扫描二维码咨询在线客服
QQ客服
QQ客服二维码
QQ客服
扫描二维码咨询在线客服

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格式）

白名单接口

查询白名单接口

http://localhost:4173/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"
      }
    ]
  }
}

添加白名单接口

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

删除白名单接口

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

接入代码示例

# ============================================
# cURL 代理示例 - 支持 HTTP/HTTPS/SOCKS5 协议
# ============================================

# ----- HTTP 代理 -----
# 适用于普通HTTP请求
curl -x http://api.mayihttp.com:12984 -U "user:password" http://ipinfo.io

# ----- HTTPS 代理 -----
# 适用于HTTPS请求，使用HTTP代理隧道方式
curl -x http://api.mayihttp.com:12984 -U "user:password" https://ipinfo.io

# ----- SOCKS5 代理 -----
# 适用于需要SOCKS5协议的场景
curl -x socks5://user:password@api.mayihttp.com:12985 http://ipinfo.io

# 注意：请根据实际购买的套餐选择对应的协议和端口

安全稳定

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

极速响应

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

灵活接入

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

技术支持

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

服务器错误