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