代理管理

Updated by MoreLogin

1 获取代理列表

基本信息

POST  /api/proxyInfo/page
  • 接口描述：查询已添加的代理信息。需将MoreLogin应用更新至2.9.0及以上版本。

请求参数

Body 参数， 非必传参数可以不传递，传参格式为JSON

参数名称

类型

必传

说明

id

integer(int64)

否

需要查询的代理ID

isCloudPhoneProxy

boolean

否

是否为云手机环境可以使用的代理 true：是；false：否

pageNo

integer(int64)

否

当前页，默认：1

pageSize

integer(int64)

否

每页条数，默认：10

proxyCategoryType

integer(int32)

否

通过代理分类查询

1：云平台；2：自有IP

proxyCheckStatus

integer(int32)

否

通过检测状态查询

0：待检测，1：检测成功，2：检测失败，3：未知错误

proxyIp

string

否

代理IP

proxyName

string

否

通过代理名称查询，支持模糊搜索

proxyProviders

array

否

通过代理提供商查询

0：无，4：Oxylabs，5：Proxys.io，7：Luminati，8：Lumauto，9：Oxylabsauto，10：Trojan，11：Shadowsocks，13：ABCPROXY，14：LunaProxy，15：IPHTML，16：PiaProxy，17：922S5

默认值：0

proxyStatus

integer(int32)

否

通过代理状态查询

0：正常 ，1：待分配 ，2：升级中 ，3：已过期，4：即将过期

proxyTypes

array

否

通过代理类型查询

0：http，1：https，2：socks5，3：ssh

请求示例

{
	"id": 0,
	"isCloudPhoneProxy": true,
	"pageNo": 0,
	"pageSize": 0,
	"proxyCategoryType": 0,
	"proxyIp": "",
	"proxyName": "",
	"proxyProviders": [],
	"proxyStatus": 0,
	"proxyTypes": []
}

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"data": {
		"current": 0,
		"dataList": [
			{
				"expiryTime": 0,         //过期时间
				"id": 0,                 //主键
				"proxyCategoryType": 0,  //代理分类：1-云平台 2-自有IP
				"proxyCheckStatus": 0,   //检测状态：0-待检测 1-监测成功 2-检测失败 3-未知错误
				"proxyIp": "",           //代理Ip
				"proxyName": "",         //代理名称
				"proxyProvider": 0,      //代理提供商：默认值0-无 4-Oxylabs 5-Proxys.io 7-Luminati 8-Lumauto 9-Oxylabsauto 10-Trojan，11-Shadowsocks 13-ABCPROXY 14-LunaProxy 15-IPHTML 16-PiaProxy 17-922S5
				"proxyType": 0           //代理类型：0-http 1-https 2-socks5 3-ssh
			}
		],
		"pages": 0,
		"total": 0
	},
	"requestId": "",   // 操作请求ID
}

2 添加代理

基本信息

POST  /api/proxyInfo/add
  • 接口描述：新增自有代理。需将MoreLogin应用更新至2.9.0及以上版本。

请求参数

Body 参数， 非必传参数可以不传递，传参格式为JSON

参数名称

类型

必传

说明

city

string

否

城市

country

string

否

国家（具体的国家码详见附录），proxyProvider为16/17/18必填

encryptionType

integer(int32)

否

加密方式，proxyProvider为11时不可为空。

1：aes-128-gcm，2：aes-192-gcm，3：aes-256-gcm，4：aes-128-cfb，5：aes-192-cfb，6：aes-256-cfb，7：aes-128-ctr，8：aes-192-ctr，9：aes-256-ctr，10：rc4-md5，11：chacha20-ietf，12：xchacha20，13：chacha20-ietf-poly1305，14：xchacha20-ietf-poly1305

ipChangeAction

integer(int32)

否

是否开启IP变化监控

true：打开，false：关闭

默认：关闭

ipMonitor

boolean

否

IP变化监控

0：禁止访问，1：警告

password

string

否

密码（最多100字符）

proxyIp

string

否

代理IP，proxyProvider为16/17/18可为空，其他则必填

proxyName

string

否

代理名称（最多600字符）

proxyPort

integer(int32)

否

代理端口（仅支持输入1-65535的数字），proxyProvider为16/17/18可为空，其他则不可为空

proxyProvider

integer(int32)

否

代理提供商

0：http，1：https，2：socks5，3：ssh，4：Oxylabs，5：Proxys.io，7：Luminati，8：Lumauto，9：Oxylabsauto，10：Trojan，11：Shadowsocks，13：ABCPROXY，14：LunaProxy，15：IPHTML，16：PiaProxy，17：922S5，18：360Proxy

proxyType

integer(int32)

否

代理类型，0：http，1：https，proxyProvider为7/8时不可为空

refreshUrl

string

否

刷新URL

state

string

否

州/省

username

string

否

用户名（最多200字符）

请求示例

{
	"city": "",
	"country": "",
	"encryptionType": 0,
	"ipChangeAction": 0,
	"ipMonitor": true,
	"password": "",
	"proxyIp": "",
	"proxyName": "",
	"proxyPort": 0,
	"proxyProvider": 0,
	"proxyType": 0,
	"refreshUrl": "",
	"state": "",
	"username": ""
}

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"data": 0,  // 代理ID
	"requestId": "",   // 操作请求ID
}

3 修改代理信息

基本信息

POST  /api/proxyInfo/update
  • 接口描述：修改代理相关信息。需将MoreLogin应用更新至2.9.0及以上版本。

请求参数

Body 参数， 非必传参数可以不传递，传参格式为JSON

参数名称

类型

必传

说明

city

string

否

城市

country

string

否

国家（具体的国家码详见附录），proxyProvider为16/17/18必填

encryptionType

integer(int32)

否

加密方式，proxyProvider为11时不可为空。

1：aes-128-gcm，2：aes-192-gcm，3：aes-256-gcm，4：aes-128-cfb，5：aes-192-cfb，6：aes-256-cfb，7：aes-128-ctr，8：aes-192-ctr，9：aes-256-ctr，10：rc4-md5，11：chacha20-ietf，12：xchacha20，13：chacha20-ietf-poly1305，14：xchacha20-ietf-poly1305

id

integer(int64)

是

代理ID

ipChangeAction

integer(int32)

否

是否开启IP变化监控

true：打开，false：关闭

ipMonitor

boolean

否

IP变化监控

0：禁止访问，1：警告 

password

string

否

密码（最多100字符）

proxyIp

string

否

代理IP，proxyProvider为16/17/18可为空，其他则必填

proxyName

string

否

代理名称（最多600字符）

proxyPort

integer(int32)

否

代理端口（仅支持输入1-65535的数字），proxyProvider为16/17/18可为空，其他则不可为空

proxyProvider

integer(int32)

否

代理提供商

0：http，1：https，2：socks5，3：ssh，4：Oxylabs，5：Proxys.io，7：Luminati，8：Lumauto，9：Oxylabsauto，10：Trojan，11：Shadowsocks，13：ABCPROXY，14：LunaProxy，15：IPHTML，16：PiaProxy，17：922S5，18：360Proxy

proxyType

integer(int32)

否

代理类型，0：http，1：https，proxyProvider为7/8时不可为空

refreshUrl

string

否

刷新URL

state

string

否

州/省

username

string

否

用户名（最多200字符）

请求示例

{
	"city": "",
	"country": "",
	"encryptionType": 0,
	"id": 0,
	"ipChangeAction": 0,
	"ipMonitor": true,
	"password": "",
	"proxyIp": "",
	"proxyName": "",
	"proxyPort": 0,
	"proxyProvider": 0,
	"proxyType": 0,
	"refreshUrl": "",
	"state": "",
	"username": ""
}

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"requestId": "",   // 操作请求ID
}

4 删除代理

基本信息

POST  /api/proxyInfo/delete
  • 接口描述：批量删除不需要的代理。需将MoreLogin应用更新至2.9.0及以上版本。

请求参数

Body 参数， 非必传参数可以不传递，传参格式为JSON

参数名称

类型

必传

说明

ids

array

是

需要删除的代理ID，可批量删除（未过期的平台代理无法删除）

请求示例

[1054661322597744600,1054661322597744601]

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"requestId": "",   // 操作请求ID
}

How did we do?