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

API 提取生成

参数配置
余额: 0.00
全部省份
HTTP(S)/SOCKS5 协议
218.95.37.11:25152

提取数量

数量:
提示:单次可提取 1-200 个代理IP

API请求参数

参数名
类型
必填
说明
key
String
是*
用户密钥(key)
package_type
String
套餐类型:time(动态套餐)/balance(余额套餐)
num
Int
提取数量,范围1-200,默认为1
time
Int
IP时效:[1=3分钟, 2=5分钟, 3=10分钟, 4=15分钟, 5=30分钟];余额套餐还支持[6=3小时],默认为1
mode
Int
协议类型:1(HTTP)/3(SOCKS5),默认为1
type
Int
返回格式:1(TXT)/2(JSON),默认为2
auth
Int
是否返回代理用户名和代理密码:1(返回)/0(不返回),默认为1
region_name
Int
是否返回地区名称:1(返回)/0(不返回),默认为1
province
String
省份筛选,留空则不限制
city
String
城市筛选,留空则不限制

成功响应 (JSON格式)

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

成功响应 (TXT格式)

123.456.789.012:8080

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

错误响应

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

返回字段说明

字段名
类型
说明
code
Int
状态码,200表示成功
success
Boolean
请求是否成功
message
String
提示信息
data
Array
IP数据列表
ip
String
IP地址
port
Int
端口号
user
String
代理用户名(auth=1时返回)
pass
String
代理密码(auth=1时返回)
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": "白名单删除成功"
}

接入代码示例

# ============================================
# 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小时技术支持,专业团队服务