API 文档

从注册到发起第一个请求,再到查询用量与余额,一份文档讲清整套接入流程。

快速开始

四步完成接入,几分钟内发起第一个移动出口请求。

1

注册账号

免费注册后自动进入控制台。

2

获取 API Key

在控制台获取账号唯一的 API Key,可随时重置,请妥善保管。

3

调用接口取连接信息

用 API Key 调用接口,取回 SOCKS5 / HTTP / HTTPS 连接信息。

4

配置到采集程序

将连接信息填入代理配置,即可从真实 4G / 5G 移动出口发起请求。

① 用 API Key 获取连接信息
curl "https://www.gaofengxt.cn/api/v1/credentials" \
  -H "Authorization: Bearer YOUR_API_KEY"
② 用连接信息发起首个请求
curl -x proxy.gaofengxt.cn:20001 \
  -U "ipx_demo8f2k-zone-mob-region-hangzhou:YOUR_PASSWORD" \
  https://ipinfo.io
代理接入

同一组移动代理凭证通过用户名字段切换轮换与粘滞会话。

项目说明
HTTP / HTTPS 网关proxy.gaofengxt.cn:20001
SOCKS5 网关proxy.gaofengxt.cn:20002
支持协议SOCKS5 / HTTP / HTTPS(端口不同)
鉴权方式用户名密码鉴权

两种会话模式

不带会话字段就是轮换模式;同时带 session 与 sessTime 就是粘滞模式。

轮换模式

每次建立新连接时重新调度出口 IP,用户名到 region 为止。

轮换模式
curl -x proxy.gaofengxt.cn:20001 \
  -U "ipx_demo8f2k-zone-mob-region-hangzhou:YOUR_PASSWORD" \
  https://ipinfo.io

粘滞会话模式

同一 session 在 sessTime 指定的分钟数内保持同一出口 IP。

session 为自定义会话标识,sessTime 为保持分钟数;当前网关默认上限为 1440 分钟。

粘滞模式 · 保持 5 分钟
curl -x proxy.gaofengxt.cn:20001 \
  -U "ipx_demo8f2k-zone-mob-region-hangzhou-session-demo230pnqdnf-sessTime-5:YOUR_PASSWORD" \
  https://ipinfo.io

用户名字段

字段顺序固定,粘滞模式必须同时提供 session 与 sessTime。

参数格式示例说明
region-zone-mob-region-<地区代码>-zone-mob-region-hangzhou选择移动出口地区;该字段是基础用户名的一部分
session-session-<会话ID>-session-demo230pnqdnf自定义粘滞会话标识;轮换模式不填写
sessTime-sessTime-<分钟>-sessTime-5粘滞会话保持时长;必须与 session 同时出现
完整粘滞会话示例
curl -x proxy.gaofengxt.cn:20001 \
  -U "ipx_demo8f2k-zone-mob-region-hangzhou-session-demo230pnqdnf-sessTime-5:YOUR_PASSWORD" \
  https://ipinfo.io
多语言接入示例

每种语言均给出 SOCKS5、HTTP 与 HTTPS 三种写法,复制后替换连接信息即可使用。

curl --socks5-hostname proxy.gaofengxt.cn:20002 \
  -U "ipx_demo8f2k-zone-mob-region-hangzhou:YOUR_PASSWORD" \
  https://ipinfo.io
REST API

获取代理连接信息、查询账户余额与用量数据的开放接口,统一以 JSON 交互。

Base URL https://www.gaofengxt.cn/api/v1,请求头携带 Authorization: Bearer API_KEY。

每个账号仅有唯一一把 API Key,可在控制台随时重置,重置后旧密钥立即失效。

流量 / 用量字段一律为整数字节数(如 5368709120 约等于 5 GiB),展示层可自行换算为易读单位;余额字段 balanceCNY 例外,单位为人民币元。

credentials 返回的 username 是账号级用户名,发起代理请求时需按「代理接入」小节的语法追加 region 与会话字段。

GET/credentials

获取代理连接信息(网关地址、端口与账号凭据)

请求
curl "https://www.gaofengxt.cn/api/v1/credentials" \
  -H "Authorization: Bearer tk_9f2kQwZ7ndLpXvR4tsBmHy6eUcAj3TgKrWn5PdVx"
响应
{
  "code": 200,
  "message": "ok",
  "data": {
    "host": "proxy.gaofengxt.cn",
    "port": 20001,
    "protocols": [
      "socks5",
      "http",
      "https"
    ],
    "endpoints": {
      "http": {
        "host": "proxy.gaofengxt.cn",
        "port": 20001
      },
      "https": {
        "host": "proxy.gaofengxt.cn",
        "port": 20001
      },
      "socks5": {
        "host": "proxy.gaofengxt.cn",
        "port": 20002
      }
    },
    "username": "ipx_demo8f2k",
    "password": "YOUR_PASSWORD",
    "rotatedAt": "2026-07-20T08:12:44.000Z"
  }
}
GET/account/balance

查询账户余额与当前流量池

请求
curl "https://www.gaofengxt.cn/api/v1/account/balance" \
  -H "Authorization: Bearer tk_9f2kQwZ7ndLpXvR4tsBmHy6eUcAj3TgKrWn5PdVx"
响应
{
  "code": 200,
  "message": "ok",
  "data": {
    "balanceCNY": 328.5,
    "traffic": {
      "purchasedBytes": 214748364800,
      "usedBytes": 53687091200,
      "remainingBytes": 161061273600,
      "expiresAt": "2026-10-01T00:00:00.000Z"
    }
  }
}
GET/traffic?days=30

查询逐日流量消耗;days 可选,默认 30,取值范围 1–360

请求
curl "https://www.gaofengxt.cn/api/v1/traffic?days=30" \
  -H "Authorization: Bearer tk_9f2kQwZ7ndLpXvR4tsBmHy6eUcAj3TgKrWn5PdVx"
响应
{
  "code": 200,
  "message": "ok",
  "data": {
    "days": 30,
    "byDay": [
      {
        "date": "2026-07-29",
        "bytes": 6120328396
      },
      {
        "date": "2026-07-30",
        "bytes": 4294967296
      }
    ],
    "totalBytes": 161061273600
  }
}
错误码与限速

统一错误结构与分级限速策略,便于客户端做好重试与降级。

错误码HTTP 状态说明
200200请求成功
40001400参数校验失败,请检查请求参数(如 days 超出 1–360)
40101401鉴权失败:缺少 Authorization 请求头,或 API Key 无效(已被重置)
40301403账号已被冻结,或目标命中黑名单被网关拦截
42901429请求超出限速阈值,请按 Retry-After 退避重试
50001500服务端内部错误,请重试或联系技术支持

限速策略

全部流量包不限并发连接数;开放 REST API 按 API Key 限速 200 RPS(每秒固定窗口),超出阈值返回 429 与错误码 42901,请按 Retry-After 退避重试。

还没有网关账号?

免费注册开通控制台,几分钟内完成接入并跑通首个请求。

查看套餐免费注册