1.动态代理类型接口

1.1获取动态类型代理详细信息

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

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" 
// DynamicPhoneProxy=动态手机 或 DynamicResidentialProxy==动态住宅
}

注释：请求查询此代理ID的详细信息。

参数名	参数值	是否必填	参数类型	描述说明
proxy_type	DynamicResidentialProxy	是	string	动态代理产品类型 DynamicPhoneProxy=动态手机 DynamicResidentialProxy==动态住宅

2.2响应示例

示例：

{
"code": 200,
"message": "success",
"data": {
"results": {
"proxy_info": {
"proxy_id": "SC2506094076ff", //代理编号
"username": "ckgv5la7mf62", //用户名
"password": "bdam3vord9a7", //密码
"gigabyte": 12, //套餐购买流量总和(G单位)
"use_gigabyte": 0, //已使用流量(字节单位)
"proxy_status": 1,
"proxy_type": "DynamicResidentialProxy", //代理类型
"proxy_format": "DynamicResidentialF", //代理产品种类
"expire_time": 1752039799, //代理过期时间戳
"add_time": 1749447799 //代理创建时间戳
},
"route_list": [
              {
					"conn_route_code": "AS",//亚洲线路
					"conn_addr": "asia-relaydng.onesproxy.vip",//连接地址
					"socks5_port": "1337",//socks5连接端口
					"http_port": "1337"//http连接端口
				},
				{
					"conn_route_code": "NA",//代理线路美洲
					"conn_addr": "na-relaydng.onesproxy.vip",//连接地址
					"socks5_port": "1337",//socks5连接端口
					"http_port": "1337"//http连接端口
				},
				{
					"conn_route_code": "EU",//代理线路欧洲
					"conn_addr": "eu-relaydng.onesproxy.vip",//连接地址
					"socks5_port": "1337",//socks5连接端口
					"http_port": "1337"//http连接端口
				} 
],
"setting_info": {
"stick_time": 120, //粘性时间上限  手机动态最高只支持3分钟
"format": {
"1001": "HostIP:Port:Username:Password",//支持的代理格式：主机IP:端口:用户名:密码
"1002": "ProxyProtocol://Username:Password@HostIP:Port",//支持的代理格式：代理协议://用户名:密码@主机IP:端口
"1003": "Username:Password@HostIP:Port",//支持的代理格式：用户名:密码@主机IP:端口
"1004": "Username:Password:HostIP:Port",//支持的代理格式：用户名:密码:主机IP:端口
"1005": "HostIP:Port:@Username:Password",//支持的代理格式：主机IP:端口:@用户名:密码
}
}
}
}
}

注释：请求成功，返回此代理ID 的详细信息，包含连接地址、账号密码、已经剩余流量等信息。

参数名	参数值	参数类型	描述说明
code	200	number	状态码
message	success	string	状态说明
data		object	-
data.results		object	-
data.results.proxy_info		object	-
data.results.proxy_info.proxy_id	SC2506094076ff	string	代理编号
data.results.proxy_info.username	ckgv5la7mf62	string	用户名
data.results.proxy_info.password	bdam3vord9a7	string	密码
data.results.proxy_info.gigabyte	12	number	套餐购买流量总和(G单位)
data.results.proxy_info.use_gigabyte	0	number	已使用流量(字节单位)
data.results.proxy_info.proxy_status	1	number	-
data.results.proxy_info.proxy_type	DynamicResidentialProxy	string	代理类型
data.results.proxy_info.proxy_format	DynamicResidentialF	string	代理产品种类
data.results.proxy_info.expire_time	1752039799	number	代理过期时间戳
data.results.proxy_info.add_time	1749447799	number	代理创建时间戳
data.results.route_list		array
data.results.route_list.en_conn_route	Asia	string	代理线路
data.results.route_list.conn_addr	asia- relaydng.onesproxy.vip	string	代理连接地址
data.results.route_list.socks5_port	1337	string	socks5代理端口
data.results.route_list.http_port	1337	string	http代理端口
data.results.setting_info		object
data.results.setting_info.stick_time	120	number	粘性时间上限
data.results.setting_info.format		object
data.results.setting_info.format.1001	HostIP:Port:Username:Password	string	支持的代理格式
data.results.setting_info.format.1002	ProxyProtocol://Username:Password@HostIP:Port	string	支持的代理格式
data.results.setting_info.format.1003	Username:Password@HostIP:Port	string	支持的代理格式
data.results.setting_info.format.1004	Username:Password:HostIP:Port	string	支持的代理格式
data.results.setting_info.format.1005	HostIP:Port:@Username:Password	string	支持的代理格式

动态代理类型API调用