获取动态类型代理列表

动态代理类型

• DynamicResidentialProxy=动态住宅

• DynamicPhoneProxy=动态手机

• DynamicResidentialProxy：动态住宅下有

• DynamicResidentialF=动态住宅代理

• DynamicPhoneProxy：动态手机下有

• DynamicMobileA=动态手机A区

目前动态代理提供以下套餐流量额度

• 5G/30天 -40G/90天 -120G/90天 - 360G/180天 - 660G/180天 - 1000G/365天 - 3000G/365天

PS：目前动态手机只支持英国、美国、奥地利

1.动态代理类型接口

1.1获取动态类型代理列表信息

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

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）

示例：

{
    "proxy_type": "DynamicResidentialProxy", //动态代理类型,必填
    "proxy_format": "DynamicResidentialF" ,//动态产品种类,必填
    // "proxy_ids":["SC251203610314"] //动态代理编号集合,非必填
    // "order_id":"TO2506176P5i36", //动态订单id,非必填
    "page":1,
    "page_size": 100 //非必填,<=20默认为20条
  
}

注释：请求查询动态住宅代理的列表信息。

参数名	参数值	是否必填	参数类型	描述说明
proxy_type	DynamicResidentialProxy	是	string	动态代理类型，必填
proxy_format	DynamicResidentialF	是	string	动态产品种类，必填
proxy_ids	SC251203610314	否	array	代理ID集合，非必填
order_id	TO2506176P5i36	否	string	动态订单id，非必填
page	1	否	number	页数，非必填
page_size	100	否	number	非必填,<=20默认为20条

2.2响应示例

示例：

{
	"code": 200,
	"message": "success",
	"data": {
		"count": 1,
		"proxy_format": "DynamicResidentialF",//动态代理产品种类
		"proxy_type": "DynamicResidentialProxy",//动态代理类型
		"results": [
			{
				"proxy_id": "SC2510153e81f4",//动态代理编号
				"proxy_status": 2,//代理状态：-1未启动，0等待，1正常，2关闭
				"proxy_route": "A区",//
				"order_id": "OD25101507da5d",//订单ID
				"en_name": "5G",//套餐名称
				"remain_traffic": -7035498,//剩余流量byte，字节，单位KB
				"created_at_unix": 1760496321,//创建时间戳
				"expired_at_unix": 1763088321,//过期时间戳
				"is_allowed_direct": 0,//是否支持ip方式连接，1支持，0不支持
				"is_allowed_udp": 0//是否启用UDP，1是，0否
			}

		]
	}
}

注释：请求成功，返回显示动态代理列表信息。

参数名	参数值	参数类型	描述说明
code	200	number	状态码
message	success	string	状态说明
data		object	-
data.count	1	number	返回代理的数量
data.proxy_format	DynamicResidentialF	string	代理产品种类
data.proxy_type	DynamicResidentialProxy	string	代理类型
data.results		array	-
data.results.proxy_id	SC250606326e39	string	代理编号
data.results.proxy_status	1	number	代理状态:-1:未启动, 0:等待, 1:正常, 2:关闭
data.results.proxy_route	A区	string	所属路线
data.results.order_id	OD250606b77d73	string	订单D
data.results.en_name	5	string	套餐名称
data.results.remain_traffic	1068195099	number	剩余流量
data.results.created_at_unix	1748162654	number	创建时间戳
data.results.expired_at_unix	1750754654	number	过期时间戳