适用范围与快速开始
本文介绍国内动态 IP 与余额套餐的 GET 提取及只读查询。长效、隧道与海外产品使用各自的连接配置。所有示例凭据均为占位值,不可直接使用。
- 在个人中心对应产品的「API 接入」配置并复制 GET 提取地址。
- 程序调用该地址取得连接凭据,再按代理接入代码示例配置代理连接。
生成或复制地址不提取、不计费。请使用 HTTPS,勿公开含密钥的地址;新提取请生成新请求号。
GET 提取地址
https://www.mayihttp.com/get_api.php?key=YOUR_API_KEY&package_type=time&package_id=YOUR_PACKAGE_ID&num=1&time=1&type=2&auth=1&request_id=0123456789abcdef01234567
将 YOUR_API_KEY、YOUR_PACKAGE_ID 换为实际值。示例固定 request_id 仅解释格式,不能用于多次新提取;余额模式改为 package_type=balance 并移除 package_id。time 是编号,不是直接填写分钟数。
请求参数
| 参数 | 要求 | 说明 |
|---|
| key | 必填 | API 接入中的密钥;动态 IP 与余额套餐共用。 |
| package_type | 必填 | time=国内动态套餐,balance=国内余额提取。其他产品不使用此接口。 |
| package_id | 动态建议传入 | 24 位小写十六进制套餐 ID,生成地址自动携带。无效、时长不符或额度不足时报错,不换包、不转扣余额。旧链接省略时兼容匹配同一时长套餐;balance 不传。 |
| num | 可选 | 1–200,默认 1。 |
| time | 可选 | 编号 1=3 分钟、2=5 分钟、3=10 分钟、4=15 分钟、5=30 分钟;余额另支持 6=180 分钟。默认 1;动态须与套餐时长一致。 |
| type | 可选 | 1=TXT,2=JSON。接口默认 2,网页默认生成 TXT 地址。 |
| sep | 可选 | TXT:crlf(默认)、br(输出 <br/>)、cr、lf、tab、custom。JSON 忽略分隔符。 |
| custom_sep | 条件必填 | TXT 且 sep=custom 时为 1–20 个可见字符,须 URL 编码。不解析转义字符串,不接受控制字符。 |
| auth | 可选 | 固定为 1,返回连接账号密码;不支持白名单免密。 |
| mode | 可选 | 1=HTTP 格式(默认),3=SOCKS5 格式;TXT 在 SOCKS5 格式时增加 socks5://。 |
| province / city | 可选 | 省份 2 位,兼容 6 位省级代码;城市 6 位,例如 province=51、city=510100。留空随机。 |
| isp | 可选 | ct=电信、cu=联通、cm=移动,留空不限。 |
| region_name / isp_name | 可选 | 0=不附加名称、1=附加。接口默认 1,网页生成地址为 0。 |
| request_id | 建议传入 | 24 位小写十六进制。每次新提取新建一个,重试沿用原号和原参数。 |
地区代码见地区代码表;实际可选地区以公开 domestic_proxy.php?action=catalog 中对应商品的 regions 为准。兼容参数 action 可省略或为 ip;quchong 兼容值仅为 1,不承诺每次新提取必定获得不同出口。
成功返回与代理连接
TXT(type=1)默认每行一条 入口:端口:账号:密码;JSON(type=2)从 data[] 读取 ip、port、user、pass 和 expire_time。
{
"code": 200,
"success": true,
"message": "提取成功",
"data": [
{
"ip": "proxy.example.com",
"port": 9001,
"user": "customer-EXAMPLE-cc-CN-sessid-EXAMPLE-exp-EXAMPLE-backup-1",
"pass": "EXAMPLE_PASSWORD",
"expire_time": "2026-12-01 12:03:00"
}
],
"request_id": "0123456789abcdef01234567",
"status": "charged",
"ready": true
}
- ip 字段可能是域名,多条结果可能共用入口。必须使用对应的完整 user 和 pass,勿修改签名参数。
- expire_time 按北京时间(UTC+8)显示;结果到期不能靠重试延长。
- 支持 HTTP、HTTPS CONNECT 和 SOCKS5 TCP 账密连接。提取格式与客户端实际代理协议应对应。
- TXT 在开通中、到期或失败时也可能返回 JSON,须检查 HTTP 状态与 Content-Type,不能把错误正文当作代理。
重试与计费
动态提取消耗条数额度,余额提取扣金额。省略 request_id 时,每次访问或刷新都可能创建新提取,再次计次或扣费。程序接入建议在发请求前生成并保存请求号及参数。
- HTTP 202 / pending:尚未扣费或计次。取 JSON 的 request_id 或响应头 X-Request-Id,约 2 秒后用原号、原参数重试。
- 网络超时:有原请求号时先查询或重试原请求;未传且未收到请求号时,先核对提取记录,不能认定请求未成功。
- status=charged:表示已结算,即使 ready=false 也不要换号,查询或重试原请求。
- HTTP 409:请求已取消或到期。若需要新提取,生成新号;新请求会按规则重新计费或计次。
请求号生成:Python 使用 secrets.token_hex(12);Node.js 使用 crypto.randomBytes(12).toString("hex")。原请求号不能改套餐、数量、时长或地区,也不能用于不同任务。
只读查询接口
使用 GET /domestic_proxy.php?action=…,不新增提取或扣费。除 catalog 外,以下查询均通过请求头 X-API-Key 提供密钥。
| action | 用途 |
|---|
| catalog | 无需登录。从 data.products 选择 id=dynamic 或 balance;读取对应 regions 和 rates,不依赖节点数量。 |
| wallet | 查询当前用户的钱包余额、费率与带宽;不需要重复费率时传 include_rates=0。 |
| dynamic_packages | 查询当前用户的套餐 ID、时长、状态、今日及总剩余条数、重置时间。 |
| extraction | 传 request_id 查询该次提取和有效凭据;不是重新提取。 |
| extractions | 查询最近 50 条记录,可传 billing_mode=quota 或 balance;有效凭据通过 extraction 获取。 |
curl "https://www.mayihttp.com/domestic_proxy.php?action=extraction&request_id=0123456789abcdef01234567" -H "X-API-Key: YOUR_API_KEY"
错误处理
失败以实际 message 为准,常见响应含 success=false 与错误说明。提取接口的 HTTP 状态、业务状态与代理连接状态应分别判断。
| HTTP 状态 | 处理 |
|---|
| 400 | 检查提取密钥、参数、套餐有效期、额度或余额。提取密钥错误也可能返回 400。 |
| 401 | 只读查询缺少或使用了失效的 X-API-Key。 |
| 403 | 操作需网页登录,例如重置密钥。 |
| 405 | 请求方法或 action 不匹配;提取用 GET get_api.php,查询用 GET domestic_proxy.php。 |
| 409 | 原提取已取消或到期,按上方重试规则处理。 |
| 503 | 服务或出口暂不可用,保留原号、原参数稍后查询或重试。 |
更多问题见提取与扣费排查和连接故障排查。