浏览器环境

1 启动浏览器环境

基本信息

接口描述: 用于启动环境，需要指定环境ID，启动成功后可以获取环境debug接口用于执行selenium和puppeteer自动化。 Selenium需要使用到对应内核版本匹配的Webdriver。启动环境后可在返回值中拿到对应的Webdriver的路径。需将MoreLogin应用更新至2.15.0及以上版本。

注：使用此接口需启动MoreLogin客户端并成功登录。

请求参数

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

请求示例

{
  "envId": "1795695767353204736",
  "encryptKey": "xxx"
}

返回数据

{
  "code": 0,  // 返回结果编码 0:正常 其他编码都是异常
  "msg": "",  // 错误信息
  "data": {
    "envId": "1795695767353204736", // 环境 ID
    "debugPort": "61598",         // debug port
    "webdriver": "xxx" // path of webdriver.exe
  }
}

2 关闭浏览器环境

基本信息

接口描述: 关闭指定环境，需要指定环境ID。需将MoreLogin应用更新至2.15.0及以上版本。

注：使用此接口需启动MoreLogin客户端并成功登录。

请求参数

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

请求示例

{
  "envId": "1795695767353204736"
}

返回数据

{
  "code": 0,  // 返回结果编码 0:正常 其他编码都是异常
  "msg": "",  // 错误信息
  "data": {
    "envId": "1795695767353204736", // 环境 ID
  }
}

3 快速创建浏览器环境

基本信息

接口描述: 快速创建环境，支持设置环境的浏览器、操作系统、创建环境数量。创建成功后返回环境ID。需将MoreLogin应用更新至2.14.0及以上版本。

注：使用此接口需启动MoreLogin客户端并成功登录。

请求参数

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

请求示例

{
	"browserTypeId": 0,
	"groupId": 0,
	"isEncrypt": 0,
	"operatorSystemId": 0,
	"quantity": 0
}

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"data": [1,2,3],  // 环境ID数组
	"requestId": "",   // 操作请求ID
}

4 高级创建浏览器环境

基本信息

接口描述: 高级创建环境，支持设置环境的平台账号密码、cookie、指纹信息等等。创建成功后返回环境ID。需将MoreLogin应用更新至2.14.0及以上版本。

注：使用此接口需启动MoreLogin客户端并成功登录。

请求参数

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

accountInfo

advancedSetting

time_zone

web_rtc

geo_location

language

resolution

font

canvas

webgl_image

webgl_metadata

audio_context

media_device

client_rects

speech_voise

bluetooth

battery

port_scan_protection

web_gpu

afterStartupConfig

请求示例

{
	"accountInfo": {
		"customerUrl": "",
		"password": "",
		"platformId": 0,
		"siteId": 0,
		"username": ""
	},
	"advancedSetting": {},
	"afterStartupConfig": {
		"afterStartup": 0,
		"autoOpenUrls": []
	},
	"browserCore": 0,
	"browserTypeId": 0,
	"cookies": "",
	"envName": "",
	"envRemark": "",
	"groupId": 0,
	"isEncrypt": 0,
	"operatorSystemId": 0,
	"proxyId": 0,
	"tagIds": [],
	"uaVersion": 0
}

返回数据

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

5 修改浏览器环境

基本信息

接口描述: 修改环境参数，包括环境名称、代理信息、指纹信息等。创建成功后返回环境ID。需将MoreLogin应用更新至2.14.0及以上版本。

注：使用此接口需启动MoreLogin客户端并成功登录。

请求参数

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

accountInfo

advancedSetting

time_zone

web_rtc

geo_location

language

resolution

font

canvas

webgl_image

webgl_metadata

audio_context

media_device

client_rects

speech_voise

bluetooth

battery

port_scan_protection

web_gpu

afterStartupConfig

请求示例

{
	"accountInfo": {
		"customerUrl": "",
		"password": "",
		"platformId": 0,
		"siteId": 0,
		"username": ""
	},
	"advancedSetting": {},
	"afterStartupConfig": {
		"afterStartup": 0,
		"autoOpenUrls": []
	},
	"browserCore": 0,
	"cookies": "",
	"envName": "",
	"envRemark": "",
	"groupId": 0,
	"envId": 0,
	"proxyId": 0,
	"tagIds": [],
	"uaVersion": 0
}

返回数据

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

6 删除浏览器环境

基本信息

接口描述: 删除不需要的环境，删除后7天内可在「回收站」中找回。需将MoreLogin应用更新至2.14.0及以上版本。

注：使用此接口需启动MoreLogin客户端并成功登录。

请求参数

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

请求示例

{
	"envIds": []
        "removeEnvData": true
}

返回数据

{
	"code": 0,  // Return result code 0:Normal Other codes are exceptions.
	"msg": "",  // Error message
	"data": true,
	"requestId": "",   // Operation request ID
}

7 获取浏览器环境列表

基本信息

接口描述: 查询已添加的环境信息。用户仅能查询自己有权限的环境信息。需将MoreLogin应用更新至2.14.0及以上版本。

请求参数

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

请求示例

{
	"envName": "",
	"groupId": 0,
	"envId": 0,
	"pageNo": 0,
	"pageSize": 0
}

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"data": {
		"current": 0,
		"dataList": [            // 环境列表信息
			{
				"envName": "",   // 环境名称
				"groupId": 0,    // 分组ID
				"envId": 0,         // 环境ID
				"proxyId": 0     // 代理ID
			}
		],
		"pages": 0,
		"total": 0
	},
	"requestId": "",   // 操作请求ID
}

8 获取浏览器环境详情

基本信息

接口描述: 查询环境详情信息。用户仅能查询自己有权限的环境信息。需将MoreLogin应用更新至2.14.0及以上版本。

请求参数

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

请求示例

{
	"envId": 0
}

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"data": {
		"accountInfo": {         // 账号信息
			"customerUrl": "",   // 自定义平台url
			"password": "",      // 密码
			"platformId": 0,     // 平台ID
			"siteId": 0,         // 站点ID
			"username": ""       // 用户名
		},
		"advancedSetting": {},   // 高级配置参数
		"afterStartupConfig": {  // 启动后设置信息
			"afterStartup": 0,   // 启动后设置，1：继续浏览上次打开的网页，2：打开指定的网页，3：打开指定的网页和平台，4：继续浏览上次打开的网页和平台
			"autoOpenUrls": [],  // 打开指定的网页信息
			"platformUrl": ""    // 平台地址
		},
		"browserCore": 0,        // 内核版本号
		"browserTypeId": 0,      // 浏览器类型，1：Chrome，2： Firefox
		"cookies": "",           // Cookie
		"envName": "",           // 环境名称
		"envRemark": "",         // 环境备注
		"groupId": 0,            // 分组ID
		"id": 0,                 // 环境ID
		"isEncrypt": 0,          // 是否「端对端加密」，0：否，1：是
		"operatorSystemId": 0,   // 操作系统类型，1：Windows，2：macOS，3：Android，4：IOS
		"proxyId": 0,            // 代理ID
		"tagIds": [],            // 标签ID
		"uaVersion": 0           // UA
	}
	"requestId": "",   // 操作请求ID
}

9 获取浏览器内核版本列表

基本信息

接口描述: 查询可用的浏览器内核版本。需将MoreLogin应用更新至2.14.0及以上版本。

注：使用此接口需启动MoreLogin客户端并成功登录。

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"data": [
		{
			"browserType": 0, // 浏览器类型，1：Chrome，2： Firefox
			"versions": []    // 版本号
		}
	],
	"requestId": "",   // 操作请求ID
}

10 获取浏览器环境UA

基本信息

接口描述: 获取可用的浏览器环境UA。需将MoreLogin应用更新至2.14.0及以上版本。

注：使用此接口需启动MoreLogin客户端并成功登录。

请求参数

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

请求示例

{
	"os": 0,
	"osVersion": "",
	"vendor": 0
}

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"data":  {
		"resolution": {   // 默认分辨率值
			"id": "",     // 分辨率ID
			"value": ""   // 分辨率值
		},
		"ua": ""          // UA
	},
	"requestId": "",   // 操作请求ID
}

11 获取分辨率

基本信息

接口描述: 根据UA获取可用的分辨率。需将MoreLogin应用更新至2.14.0及以上版本。

注：使用此接口需启动MoreLogin客户端并成功登录。

请求参数

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

请求示例

{
	"os": 0,
	"ua": ""
}

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"data": [
		{
			"id": "",    // 分辨率ID
			"value": ""  // 分辨率值
		}
	],
	"requestId": "",   // 操作请求ID
}

12 获取可配置平台

基本信息

接口描述: 获取可用的平台信息。需将MoreLogin应用更新至2.14.0及以上版本。

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"data": [
		{
			"categoryId": 0,  // 分类ID
			"groupName": "",  // 分组名称
			"groups": 0,      // 分组，0：亚马逊
			"id": 0,          // 平台ID
			"isCustomer": true,  // 是否自定义平台
			"logo": "",       // 平台图标
			"name": "",       // 平台名称
			"orderNo": 0,     // 排序编号
			"sites": [        // 站点信息
				{
					"country": "",   // 国家
					"host": "",      // 站点域名
					"id": 0,         // 站点ID
					"isDefault": true, // 语言ID
					"logo": "",      // 图标
					"name": "",      // 站点名称
					"nameBak": "",   // 站点名称备份
					"url": ""        // 站点地址
				}
			]
		}
	]
	"requestId": "",   // 操作请求ID
}

13 获取浏览器安全锁状态

基本信息

接口描述: 获取环境安全锁锁定状态。需将MoreLogin应用更新至2.14.0及以上版本。

注：使用此接口需启动MoreLogin客户端并成功登录。

请求参数

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

请求示例

{
	"envId": 0
}

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"data": {
		"envId": 0,     // 环境ID
		"locked": true  // 是否已被他人锁定
	},
	"requestId": "",   // 操作请求ID
}

14 获取时区语言列表

基础信息

• 接口描述: 获取可用的时区和语言。需将MoreLogin应用更新至2.14.0及以上版本。

注：使用此接口需启动MoreLogin客户端并成功登录。

请求参数

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

请求示例

{
	"os": 0
}

返回数据

{
	"code": 0,  // 返回结果编码 0:正常 其他编码都是异常
	"msg": "",  // 错误信息
	"data" {
		"language_list": [   // 语言列表
			{
				"id": "",    // 语言ID
				"value": ""  // 语言信息
			}
		],
		"time_zone_list": [  // 时区列表
			{
				"id": "",    // 时区ID
				"value": ""  // 时区信息
			}
		]
	},
	"requestId": "",   // 操作请求ID
}

15 清除环境本地缓存

基础信息

描述:清除本地配置文件缓存。需要将 MoreLogin 应用程序更新至 2.28.0 及以上版本。

请求参数

参数格式为 JSON。

请求示例

{
      "envId": "",  
      "localStorage": true, 
      "indexedDB": false,  
      "cookie": false,  
      "extension": false
}

返回数据

{
	"code": 0,  // Return result code 0:Normal Other codes are exceptions.
	"msg": "",  // Error message
	"data" {	             
           "envId": "",        
           "requestId":"",   // Operation request ID
	}
}

16 刷新指纹

基础信息

描述:刷新指纹。需要将 MoreLogin 应用程序更新至 2.28.0 及以上版本。

请求参数

参数格式为 JSON。

请求案例

{
	"envId": ""，
        "uaVersion": 129， //   UA version according to the Profile
        "advancedSetting": {}
}

返回参数

{
	"code": 0,  // Return result code 0:Normal Other codes are exceptions.
	"msg": "",  // Error message
	"data": "", 	             
        "requestId":"",   // Operation request ID
}