静态代理类型
-
StaticResidentialProxy=静态住宅代理
-
StaticComputerRoomProxy=静态机房代理
-
StaticResidentialProxy:静态住宅下有
-
StaticNativeISPIP=静态原生isp代理
-
StaticBroadcastISPIP=静态广播ISP代理
-
StaticComputerRoomProxy:静态机房下有
-
StaticDCDedicatedIP=静态机房优享代理
-
StaticDCSharedIP=静态机房共享代理
1.静态代理类型接口
1.1获取静态类型代理列表信息
| 请求方法 | POST |
| 接口路径 | /v1/openApi/openApiStaticGetList |
1.2生产调用地址
https://thirdapi.onesproxy.com
2.请求头(Headers)
所有请求必须包含以下 HTTP 头:
| 请求头名称 | 类型 | 是否必填 | 参数值 | 说明 |
| Userld | string | 是 | 123456(此为演示值) | 用户唯一标识 |
| Token | string | 是 | 321654(此为演示值) | 认证令牌 |
| Content-Type | string | 是 | application/json | 固定值 |
PS:Userld和token可以登录官网后在支持中心-API集成里面查看,见下图。

2.1Body请求参数(raw-json)
示例:
{
"proxy_type": "StaticComputerRoomProxy", //静态代理类型,必填
"proxy_format": "StaticDCSharedIP", //静态产品类型,必填
"proxy_ids": [
"ST250522a2a00b"
], //静态类型IP 代理id列表,非必填
"order_id": "xxxx", //订单编号,购买/续费成功后返回,若是续费会生成最新的订单编号,原订单编号失效。非必填
"page": 1, //页数,非必填
"page_size": 100 //代理显示数量,非必填
}
PS:IP查询请使用代理ID进行查询,通过订单编号查询需提供正确的订单编号!!!
注释:查询静态代理对应产品类型的列表。
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| proxy_type | StaticResidentialProxy | 是 | string | 静态代理类型,必填 |
| proxy_format | StaticNativeISPIP | 是 | string | 静态产品类型,必填 |
| proxy_ids | - | 否 | array | 静态类型IP 的代理id列表,非必填 |
| order_id | - | 否 | string | 静态类型IP的订单编号,非必填 |
| page | - | 否 | number | 显示页数,非必填 |
| page_size | - | 否 | number | 显示数量,非必填 |
2.2响应示例
示例
{
"code": 200,
"message": "success",
"data": {
"count": 1,
"proxy_format": "StaticNativeISPIP",//代理类型
"proxy_type": "StaticResidentialProxy",//产品类型
"results": [
{
"proxy_id": "ST250605d9aaeee",//代理id
"username": "gc0OhrmGuQ",//代理ip用户
"password": "zdW4mDzZjK",//代理ip密码
"ip": "eproxy.onesproxy.vip",//原生连接地址
"port": "13474",//连接端口
"protocols": "socks5",//协议类型
"proxy_status": 1,//代理状态:-1:未启动, 0:等待, 1:正常, 2:关闭
"continents_code": "AS",//代理ip归属国家代码
"continents_name": "Asia",//代理ip归属国家名称
"country_code": "MY",//代理ip归属洲代码
"country_name": "Malaysia",//代理ip归属洲名称
"out_ip": "14.192.49.138",//出口ip
"white_ip": "", //授权白名单
"order_id": "OD2506057c0631",//订单编号
"auto_extend": -1,//是否自动续费,1=启动,-1=关闭
"created_at_unix": 1749090592,//创建时间戳
"expired_at_unix": 1751682592//代理ip过期时间戳
"is_allowed_direct": 1,//是否支持ip方式直连,1支持,0不支持
"is_allowed_udp": 1//是否启用UDP,1:是,0:否
}
]
}
}
注释:请求成功,显示当前页代理列表的所有代理显示信息。
| 参数名 | 参数值 | 参数类型 | 描述说明 |
|---|---|---|---|
| code | 200 | number | 状态码 |
| message | success | string | 状态说明 |
| data | object | - | |
| data.count | 102 | number | 默认分页的代理总数量 |
| data.proxy_type | StaticResidentialProxy | string | 代理类型 |
| data.proxy_format | StaticNativeISPIP | string | 代理产品 |
| data.results | array | - | |
| data.results.proxy_id | ST250605d9aeee | string | 代理id |
| data.results.username | bzu2z451qc | string | 代理ip用户 |
| data.results.password | 3m6mec41bo | string | 代理ip密码 |
| data.results.ip | eproxy.onesproxy.vip | string | 原生连接地址 |
| data.results.port | string | 连接端口 | |
| data.results.protocols | string | 协议类型 | |
| data.results.proxy_status | -1 | number | 代理状态:-1:未启动, 0:等待, 1:正常, 2:关闭 |
| data.results.white_ip | string | 授权ip | |
| data.results.continents_code | AS | string | 代理ip归属洲代码 |
| data.results.continents_name | Asia | string | 代理ip归属洲名称 |
| data.results.country_code | MY | string | 代理ip归属国家代码 |
| data.results.country_name | Malaysia | string | 代理ip归属国家名称 |
| data.results.out_ip | 14.192.49.138 | string | 出口ip |
| data.results.order_id | OD2506057c0631 | string | 订单编号 |
| data.results.white_ip | string | 授权白名单 | |
| data.results.created_at_unix | 1749090592 | number | 创建时间戳 |
| data.results.expired_at_unix | 1751682592 | number | 代理ip过期时间戳 |
| data.results.auto_extend | 1 | number | 是否自动续费1=自动,-1=关闭 |
|
is_allowed_direct
|
1 | number | 是否支持ip方式连接:1支持0不支持 |
|
is_allowed_udp
|
1 | number | 是否启用UDP:1:是,0:否 |