API 文档

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

快速开始

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

1

注册账号

免费注册后自动进入控制台,系统赠送体验流量额度。

2

获取 API Key

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

3

调用接口取连接信息

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

4

配置到采集程序

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

① 用 API Key 获取连接信息
curl https://api.taichang.cc/v1/credentials \
  -H "Authorization: Bearer API_KEY"
② 用连接信息发起首个请求
curl -x gw.taichang.cc:24001 \
  -U "ipx_demo8f2k-zone-mob-region-us:YOUR_PASSWORD" \
  https://ipinfo.io
代理接入

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

项目说明
网关地址gw.taichang.cc:24001
支持协议SOCKS5 / HTTP / HTTPS
鉴权方式用户名密码鉴权

两种会话模式

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

轮换模式

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

轮换模式
curl -x gw.taichang.cc:24001 \
  -U "ipx_demo8f2k-zone-mob-region-us:YOUR_PASSWORD" \
  https://ipinfo.io

粘滞会话模式

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

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

粘滞模式 · 保持 5 分钟
curl -x gw.taichang.cc:24001 \
  -U "ipx_demo8f2k-zone-mob-region-us-session-demo230pnqdnf-sessTime-5:YOUR_PASSWORD" \
  https://ipinfo.io

用户名字段

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

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

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

curl --socks5-hostname gw.taichang.cc:24001 \
  -U "ipx_demo8f2k-zone-mob-region-us:YOUR_PASSWORD" \
  https://ipinfo.io
REST API

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

Base URL https://api.taichang.cc/v1,请求头携带 Authorization: Bearer API_KEY。

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

流量 / 用量字段一律为整数字节数(如 5368709120 约等于 5 GiB),与计费精确到字节的口径一致,展示层可自行换算为易读单位。

GET/v1/credentials

获取代理连接信息

响应
{
  "code": 200,
  "data": {
    "socks5": {
      "host": "gw.taichang.cc",
      "port": 24001,
      "username": "ipx_demo8f2k-zone-mob-region-us",
      "password": "YOUR_PASSWORD"
    },
    "http": {
      "host": "gw.taichang.cc",
      "port": 24001,
      "username": "ipx_demo8f2k-zone-mob-region-us",
      "password": "YOUR_PASSWORD"
    },
    "https": {
      "host": "gw.taichang.cc",
      "port": 24001,
      "username": "ipx_demo8f2k-zone-mob-region-us",
      "password": "YOUR_PASSWORD"
    }
  }
}
GET/v1/account/balance

查询账户余额与流量额度

响应
{
  "code": 200,
  "data": {
    "balanceBytes": 128849018880,
    "trafficLimitBytes": 2147483648000
  }
}
GET/v1/usage/realtime

查询实时用量

响应
{
  "code": 200,
  "data": {
    "activeSessions": 128,
    "bandwidthBytesPerSec": 42812500,
    "trafficTodayBytes": 61203283968
  }
}
GET/v1/traffic?startDate=2026-07-01&endDate=2026-07-20

查询周期流量明细

响应
{
  "code": 200,
  "data": {
    "totalBytes": 1610612736000,
    "byDay": [
      {
        "date": "2026-07-20",
        "bytes": 61203283968
      }
    ]
  }
}
错误码与限速

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

错误码HTTP 状态说明
200200请求成功
40001400参数校验失败,请检查请求体字段
40101401鉴权失败,API Key 无效或已吊销
40301403目标命中黑名单,请求已被网关拦截
42901429请求超出限速阈值,请按 Retry-After 退避重试
50001500服务端内部错误,请重试或联系技术支持

限速策略

全部流量包不限并发连接数,统一限速 200 RPS;超出阈值触发 429,请按 Retry-After 退避重试。

还没有网关账号?

免费注册即送体验流量额度,几分钟内完成接入并跑通首个请求。

查看套餐免费注册