OkkProxy Docs

简体中文

English

简体中文

English

主题

经销商API文档 ​

概述 ​

本文档提供经销商账号注册、子账号管理、流量充值等API接口说明。

动态对接API ​

经销商账号注册 ​

官网注册新账号并联系客服开通经销商权限。

注册地址：https://unionproxy.xyz/

创建子账号 ​

创建新的子账户用于代理服务。

请求方法: POST

请求地址:

https://start.unionproxy.xyz/ip/system/user/register

请求参数:

参数名类型必填说明
userNamestring是用户名
passwordstring是密码
confirmPasswordstring是二次确认密码
emailstring是邮箱地址
codestring否验证码（不用处理）

请求示例:

json
{
  "userName": "xxxxx",
  "password": "xxxxx",
  "confirmPassword": "xxxxx",
  "code": "",
  "email": "[email protected]"
}

返回说明:

  • code: 200 - 成功
  • 其他值 - 失败

子账户登录 ​

子账户登录获取访问令牌。

请求方法: POST

请求地址:

https://start.unionproxy.xyz/ip/login

请求参数:

参数名类型必填说明
usernamestring是用户名
passwordstring是密码

请求示例:

json
{
  "username": "xxxx",
  "password": "xxxx"
}

返回示例:

json
{
  "msg": "操作成功",
  "code": 200,
  "token": "E5w..."
}

系统账户绑定子账户（授权） ​

刚注册的用户需要创建绑定关系。

请求方法: GET

请求地址:

https://start.unionproxy.xyz/ip/authorize/tIPAuth

请求头:

参数名类型必填说明
Authorizationstring是请求凭证（Bearer + token）

请求示例:

json
{
  "Authorization": "Bearer MdNtlpQCI8E5w"
}

返回示例:

json
{
  "msg": "操作成功",
  "code": 200
}

流量查询 ​

查询账户流量使用情况。

请求方法: GET

请求地址:

https://start.unionproxy.xyz/ip/getInfo

请求头:

json
{
  "Authorization": "Bearer MdNtlpQCI8E5w"
}

返回示例:

json
{
  "msg": "操作成功",
  "code": 200,
  "user": {
    "createBy": "",
    "createTime": "2025-02-08 13:22:52",
    "shareUserId": null,
    "shareCode": "34735120",
    "money": 0.00,
    "percentage": "0.20",
    "usageBandwidth": 0.00,
    "grade": 0,
    "admin": false,
    "tusername": null,
    "gstatus": null,
    "tstatus": null,
    "ttrafficLimit": null,
    "tuseTraffic": null,
    "gid": null,
    "gname": null
  }
}

返回字段说明:

字段名说明
shareCode系统账户分享码
money系统账户余额
percentage系统账户分佣比例
tusername动态IP池子账户账号/密码
tstatus动态IP池子账户状态
ttrafficLimit动态IP池子账号总可使用流量数
tuseTraffic动态IP池账户子账户已使用流量数

刷新流量数据 ​

刷新最新的流量使用数据。

请求方法: POST

请求地址:

https://start.unionproxy.xyz/ip/system/user/timeTrafficLimit

请求头:

json
{
  "Authorization": "Bearer MdNtlpQCI8E5w"
}

返回说明: 没有返回结果，可以通过 /getInfo 获取最新使用流量情况。

代理商给用户充值 ​

为指定用户充值流量。

请求方法: GET

请求地址:

https://start.unionproxy.xyz/ip/system/user/recharge?toId=${toId}&trafficNumber=${trafficNumber}

请求头:

json
{
  "Authorization": "Bearer MdNt"
}

请求参数:

参数名类型必填说明
toIdstring是充值目标用户ID（通过"代理商查询充值用户信息"接口获取）
trafficNumbernumber是充值的流量数量

返回示例:

json
{
  "msg": "操作成功",
  "code": 200
}

代理商查询充值记录 ​

查询历史充值记录。

请求方法: GET

请求地址:

https://start.unionproxy.xyz/ip/system/user/rechargeLog

请求头:

json
{
  "Authorization": "Bearer MdNt"
}

返回示例:

json
{
  "msg": "操作成功",
  "code": 200,
  "data": [
    {
      "id": "86",
      "userId": "d8883744",
      "toUserBeforeAmount": 0.00,
      "toUserAfterAmount": 5.00,
      "fromUserBeforeAmount": 10,
      "fromUserAfterAmount": 5,
      "trafficNumber": 500.00,
      "createTime": "2025-10-13T14:42:35",
      "toUserId": "fc88893eeab07d",
      "fromUserId": "d67ef96fed1acc581a3744",
      "toUserName": "uni",
      "fromUserName": "LF8",
      "operateType": -1,
      "operateBathCode": "9fb8",
      "status": "成功"
    }
  ]
}

返回字段说明:

字段名说明
toUserBeforeAmount充值前余额
toUserAfterAmount充值后余额
fromUserBeforeAmount充值前余额（充值源账户）
fromUserAfterAmount充值后余额（充值源账户）
trafficNumber充值流量数量
toUserName充值目标账户
fromUserName充值源账户

代理商查询充值用户信息 ​

根据用户名查询用户信息，获取充值所需的用户ID。

请求方法: GET

请求地址:

https://start.unionproxy.xyz/ip/system/user/username?username=${username}

请求头:

json
{
  "Authorization": "Bearer MdNt"
}

请求参数:

参数名类型必填说明
usernamestring是充值账户的用户名

返回示例:

json
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "userName": "15625005",
    "tTrafficLimit": 8000.00,
    "userId": "sfdsdfsdfsswwww"
  }
}

静态对接API ​

注册平台账号 ​

目前只有主账号，需要通过API请求购买后自行关联到您自己的业务系统子账号。

注册地址：https://unionproxy.xyz/

平台账号登录 ​

登录获取访问令牌。

请求方法: POST

请求地址:

https://start.unionproxy.xyz/ip/login

请求参数:

参数名类型必填示例备注
usernamestring是xxxx用户名
passwordstring是xxxx密码

返回示例:

json
{
  "msg": "操作成功",
  "code": 200,
  "token": "CI8E5w..............."
}

静态列表获取 - 地区查询 ​

通过接口获取 ISP Proxies 支持的地区。

请求地址:

https://start.unionproxy.xyz/ip/ipStatic/tIspRegion/list

请求方式: GET

请求头:

参数名类型必填示例备注
Authorizationstring是"Authorization": "Bearer MdNtlpQCI8E5w"键(Authorization)：值(Bearer+空格+token)

返回示例:

json
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "USA": [
      {
        "id": 10000,
        "state": "USA",
        "country": "USA",
        "city": "USA",
        "num": 1000,
        "pricingWeek": 4.5,
        "pricingMonth": 8,
        "weekPrice": 1.00,
        "monthPrice": 3.00,
        "type": 2,
        "updateTime": null,
        "status": 1,
        "ips": null
      }
    ]
  }
}

返回字段说明:

字段名说明
state州
country国家
city市
num剩余购买数
pricingWeek用于判断是否高质量IP
pricingMonth用于判断是否高质量IP
weekPrice批发商价格（周）
monthPrice批发商价格（月）
status0=无效，1=有效地区

静态购买 ​

购买静态 IP 代理。

请求地址:

https://start.unionproxy.xyz/ip/ipStatic/dealer/paymentIsp/{type}

购买时长 type: week 或 month

请求方式: POST

请求头:

参数名类型必填示例备注
Authorizationstring是"Authorization": "Bearer MdNtlpQCI8E5w"键(Authorization)：值(Bearer+空格+token)

请求参数:

参数名类型必填示例备注
id和numarray是[{"id":43,"num":2},{"id":66,"num":1}]id：地区ID，num：购买数量

返回示例:

json
{
  "code": 200,
  "data": [
    {
      "ip": "1.1.1.1",
      "port": 6666,
      "expiration_time": 1744879015,
      "username": "swfuyfzf1",
      "password": "azudxqp1",
      "order_id": "2503131636553395"
    }
  ],
  "msg": "ok"
}

返回字段说明:

名称类型备注
codenumber状态码
ipstringIP信息
portnumber端口
expiration_timenumber到期时间
usernamestring代理账户
passwordstring代理密码
order_idstring订单ID信息

静态记录查询 ​

查询已购买的静态 IP 记录。

请求地址:

https://start.unionproxy.xyz/ip/ipStatic/tIsp/list

请求方式: GET

请求头:

参数名类型必填示例备注
Authorizationstring是"Authorization": "Bearer MdNtlpQCI8E5w"键(Authorization)：值(Bearer+空格+token)

返回示例:

json
{
  "code": 200,
  "data": [
    {
      "id": 7,
      "ip": "181.215.10.93",
      "port": 6666.0,
      "expirationTime": 1.745411969E9,
      "username": "qsimwla1",
      "password": "eoldbu1",
      "orderId": "504162039294718",
      "userId": "1",
      "createTime": "2025-04-16T20:40:16",
      "originalMoney": 5.50,
      "balanceMoney": 4.00,
      "payMoney": 1.50,
      "state": "America",
      "country": "US",
      "city": "Ashburn",
      "dateStart": "2025-04-16",
      "dateEnd": "2025-04-23",
      "portSocks": null,
      "portHttp": null,
      "type": 1
    }
  ],
  "msg": "ok"
}

静态续费 ​

批量续费静态 IP，返回成功失败结果。

请求地址:

https://start.unionproxy.xyz/ip/ipStatic/paymentIspCopy/{type}

购买时长 type: week 或 month

示例: /ipStatic/paymentIspCopy/month

请求方式: PUT

请求头:

参数名类型必填示例备注
Authorizationstring是"Authorization": "Bearer MdNtlpQCI8E5w"键(Authorization)：值(Bearer+空格+token)

请求参数:

参数名类型必填示例备注
ipsarray是[{"ip":"154.200.3.7","reginId":46},{"ip":"95.134.151.117","reginId":100}]ip：续费IP；reginId：IP对应地区的ID

返回示例（部分成功）:

json
{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "ok": [
      {
        "ip": "154.200.3.722",
        "port": 6666.0,
        "expiration_time": 1.754563385E9,
        "username": "gvsutqfq",
        "password": "ektfjngw",
        "order_id": "Thor2505080905502360"
      }
    ],
    "error": [
      "95.134.151.117"
    ]
  }
}

返回示例（全部失败）:

json
{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "error": [
      "154.200.3.78",
      "95.134.151.117"
    ]
  }
}

返回示例（余额不足）:

json
{
  "msg": "余额不足",
  "code": 500
}

返回示例（参数错误）:

json
{
  "msg": "续时ip有误！",
  "code": 500
}

常见错误码 ​

错误码说明
200操作成功
500服务器错误（如余额不足、参数错误等）
其他操作失败

联系支持 ​

如需帮助，请联系：

  • 📧 邮件：[email protected]
  • 💬 在线客服：访问官网
  • 📱 Telegram：加入用户群

© 2025 OkkProxy. All rights reserved.