请输入
菜单

获取白名单ip列表

1.动态代理类型接口

1.1获取白名单ip列表

请求方法 POST
接口路径 /v1/openApi/openApiUserAuthWhiteList

1.2生产调用地址

https://thirdapi.onesproxy.com

2.请求头(Headers)

所有请求必须包含以下 HTTP 头:

请求头名称 类型 是否必填 参数值 说明
Userid string 123456(此为演示值) 用户唯一标识
Token string 321654(此为演示值) 认证令牌
Content-Type string application/json 固定值

PS:Userld和token可以登录官网后在支持中心-API集成里面查看,见下图。

2.1Body请求参数(raw-json)

示例:

{
  "search": "1.1.1.1", // 搜索白名单IP,非必填
  "page": 1, // 页码,非必填,默认1
  "page_size": 100 // 每页数量,非必填,默认100
}

注释:查询是否添加了白名单ip。

参数名 参数值 是否必填 参数类型 描述说明
search
1.1.1.1
string 搜索白名单ip,非必填
page
1
string
页码,默认1,非必填
page_size
100
string
每页数量,默认100,非必填

2.2响应示例

示例:

{
  "code": 200,
  "message": "success",
  "data": {
    "count": 1, // 当前返回数量
    "results": [
      {
        "auth_white": "1.1.1.1", // 授权白名单IP
        "remark": "office", // 备注
        "status": 1, // 状态:1启用
        "created_at": "2026-05-18 12:00:00" // 创建时间
      }
    ]
  }
}

注释:请求成功,返回对应数量及添加的白名单ip、ip状态、创建时间。

参数名 参数值 参数类型 描述说明
code 200 number 状态码
message success string 状态说明
data   object -
count
1 number 当前返回数量
auth_white
1.1.1.1
string 授权白名单IP
remark
office
string 备注名
status
1
number
状态:1启用
created_at
2026-05-18 12:00:00
string
创建时间

2

上一个
动态代理白名单
下一个
批量新增白名单ip
最近修改: 2026-06-01