浏览器接口
创建、修改、打开浏览器等操作接口
健康检查接口,无参数,可以用来测试Local Server是否连接成功
POST
/health
{
// Response
}
创建/修改浏览器窗口,指纹对象必传。创建窗口需要随机指纹对象时,只传空对象{}即可,指纹值里,留空会随机
POST
/browser/update
Request Body
id
String
浏览器窗口id,传id时为修改,不传为创建
groupId
String
分组id,子账号创建浏览器窗口shi ,分组id必传,否则会创建到主账号下面
platform*
String
账号平台URL,如:https://www.facebook.com
platformIcon*
String
账号平台Icon,默认填写platform字段的hostname即可
url*
String
额外打开的url,多个用,分开
name*
String
浏览器窗口名称
remark*
String
备注
userName*
String
浏览器平台账号
password*
String
浏览器平台账号密码
proxyMethod*
Int
代理类型,2自定义,3提取IP,默认2
注意:设置提取IP时,需要同时设置下方dynamicIpUrl等几个字段值
proxyType*
String
自定义代理类型 ['noproxy', 'http', 'https', 'socks5', '911s5']中一个,默认noproxy
host
String
代理主机
port
Int
代理端口
proxyUserName
String
代理账号
proxyPassword
String
代理密账号码
ip
String
911 s5 ip
country
String
911 s5 国家地区code
province
String
911 s5 州/省code
city
String
911 s5 城市code
isIpNoChange
Boolean
911是否不改变IP,默认false
abortImage
Boolean
禁止加载图片,默认false
stopWhileNetError
Boolean
网络不通停止打开,默认false
dynamicIpUrl
proxyMethod = 3时,提取IP链接
dynamicIpChannel
String
提取链接服务商,rola | doveip | cloudam | common
isDynamicIpChangeIp
Boolean
提取IP,每次打开都提取新IP,默认false
syncTabs
Boolean
是否同步浏览器tabs ,默认true
syncCookies
Boolean
同步Cookie,默认true
syncIndexedDb
Boolean
同步IndexedDB,默认false,极少的情况下才需要同步
syncBookmarks
Boolean
同步书签,默认false
syncAuthorization
Boolean
同步已保存的密码,默认false
syncHistory
Boolean
同步历史记录,默认false
isValidUsername
Boolean
根据平台,用户名,密码,校验重复, false,创建时有效
ipCheckService
String
IP库,默认ip-api,选项 ip-api | ip123in | luminati,luminati为Luminati专用
allowedSignin
Boolean
允许google账号登录浏览器,默认true
clearCacheFilesBeforeLaunch
Boolean
启动前清理缓存文件
clearCookiesBeforeLaunch
Boolean
启动前清理cookie
clearHistoriesBeforeLaunch
Boolean
启动前清理历史记录
randomFingerprint
Boolean
每次启动均随机指纹
disableGpu
Boolean
是否关闭GPU硬件加速,默认false
enableBackgroundMode
Boolean
关闭浏览器后继续运行应用,默认false
muteAudio
Boolean
浏览器静音,默认false
abortMedia
Boolean
禁止视频自动播放,默认false
workbench
String
浏览器窗口工作台页面,chuhai2345 或 localServer或disable,默认chuhai2345,不需要显示工作台时,设置disable
isIpv6
Boolean
IP协议,是否是IPv6,默认false
isGlobalProxyInfo
Boolean
是否使用全局的动态代理信息,针对iphtml,oxylabs,lumauto,ipidea动态代理
syncExtensions
Boolean
同步扩展应用数据,默认false
syncUserExtensions
Boolean
跨窗口同步扩展应用,默认false
credentialsEnableService
Boolean
禁止保存密码弹窗,默认false
syncLocalStorage
Boolean
同步Local Storage数据,默认false
打开浏览器窗口,返回ws和http连接地址,以及coreVersion内核版本和driver,chromedriver path
POST
/browser/open
Request Body
id*
String
浏览器窗口id
args
Array
浏览器启动参数,注意不要传错了,数组类型,例如无头模式可以传 ["--headless"],使用非扩展中心中上传的插件可以传 ["--load-extension=xxx/extension/path"],多个插件使用逗号分隔
loadExtensions
Boolean
是否加载扩展中心中已启用的插件
extractIp
Boolean
是否尝试自动提取IP
{
success: true,
data: {
ws: 'ws://127.0.0.1:50106/devtools/browser/679fc16c-1b48-4112-b297-3659715876d2',
http: '127.0.0.1:50106',
coreVersion: '104',
driver: 'C:\\Users\\xxx\\xxx\\chromedriver.exe'
}
}
关闭浏览器窗口
POST
/browser/close
Request Body
id*
String
浏览器窗口id
删除浏览器
POST
/browser/delete
Request Body
id*
String
浏览器窗口id
获取浏览器窗口详情
POST
/browser/detail
Request Body
id
String
浏览器窗口id
{
success: true,
data: {
id: '2c9c2dsdsd323xceeeds24a30065',
seq: 41,
code: 'd3sdsddddd',
platform: 'https://www.instagram.com/',
platformIcon: 'instagram',
url: 'https%3A%2F%2Fwww.facebook.com%2F,https%3A%2F%2Fwww.amazon.com%2FBest-Sellers%2Fzgbs%2Fref%3Dzg_bs_unv_hpc_0_2314207011_4_sbg_1,https%3A%2F%2Fwww.baidu.com%2F',
name: 'ins',
userName: '',
password: '',
cookie: '[{"domain":".instagram.com","expirationDate":1680060024.48996,"hostOnly":false,"httpOnly":false,"name":"ig_nrcb","path":"/","secure":true,"session":false,"storeId":null,"value":"1"}]',
proxyMethod: 2,
proxyType: 'noproxy',
agentId: '',
host: '',
proxyUserName: '',
proxyPassword: '',
lastIp: '221.222.180.190',
lastCountry: '中国',
country: '',
province: '',
city: '',
remark: '备注',
status: 1,
operUserId: 'sdd3ds',
operUserName: '3ds3sdee',
operTime: '2022-04-14 16:11:05',
isDelete: 0,
delReason: null,
isMostCommon: 1,
tempStr: null,
createdBy: 'sdfd3ddddd',
userId: 'sdfd33dddddd',
createdTime: '2022-03-31 13:44:40',
updateBy: 'sdfsdf322222',
updateTime: '2022-04-14 16:11:05',
mainUserId: 'dfsddded323fdddd',
browserFingerPrint: {
id: '2c9c29a27fda71dd017fde8124a90066',
seq: 41,
browserId: '2c9c29a27fda71dd017fde8124a30065',
ostype: 'PC',
os: 'Win64',
version: '',
userAgent: 'Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.3887.132 Safari/537.36',
isIpCreateTimeZone: true,
timeZone: '',
webRTC: '0',
position: '1',
isIpCreatePosition: true,
isIpCreateLanguage: true,
resolutionType: '0',
resolution: '',
fontType: '0',
canvas: '0',
webGL: '0',
webGLMeta: '0',
webGLManufacturer: 'Intel Inc.',
webGLRender: 'ANGLE (NVIDIA GeForce GTX 960M Direct3D11 vs_5_0 ps_5_0)',
audioContext: '0',
mediaDevice: '0',
clientRects: '0',
hardwareConcurrency: '4',
deviceMemory: '8',
deviceNameType: '1',
deviceName: 'DESKTOP-FZEVSE',
doNotTrack: '1',
flash: '',
portScanProtect: '',
portWhiteList: '',
isDelete: 0,
colorDepth: 32,
devicePixelRatio: 1.2,
createdBy: 'sdfsdf333',
createdTime: '2022-03-31 13:44:40',
updateBy: 'sdfdsfdsf33333',
updateTime: '2022-03-31 13:45:19'
},
createdName: null,
belongUserName: null,
updateName: null,
agentIpCount: 1,
belongToMe: false,
ip: ''
}
}
获取浏览器窗口列表
POST
/browser/list
Request Body
page*
Int
分页,从0开始
pageSize*
Int
分页数量,最大,100,超出100仍然返回100条
groupId
String
分组id,非必填
name
String
窗口名称,模糊查询,非必填
remark
String
备注,模糊匹配
seq
Int
序号,精确查询
minSeq
Int
最小序号,范围查询,不可与seq同时使用
maxSeq
Int
最大序号,范围查询,不可与seq同时使用
排列窗口以及调整窗口尺寸
POST
/windowbounds
注意,参数除了type,其他参数类型都必须是整型数字。参考以下 windowbounds 对象。
Request Body
type*
String
排列方式,宫格 box , 对角线 diagonal
startX*
Int
起始X位置,默认0
startY*
Int
起始Y位置,默认0
width*
Int
宽度,最小500
height*
Int
高度,最小200
col*
Int
宫格排列时,每行列数
spaceX*
Int
宫格横向间距,默认0
spaceY
Int
宫格纵向间距,默认0
offsetX*
Int
对角线横向偏移量
offsetY*
Int
对角线纵向偏移量
批量修改浏览器窗口分组
POST
/browser/group/update
Request Body
groupId*
String
分组ID,从分组管理中获取,必填
browserIds*
Array
浏览器窗口ID数组,必填
批量修改窗口代理信息
POST
/browser/proxy/update
Request Body
ids*
Array
浏览器窗口ID数组,必填
ipCheckService*
String
IP查询渠道,默认ip-api,选项 ip-api | ip123in | luminati,luminati为Luminati专用
proxyMethod*
int
代理方式,2 自定义代理,3 提取IP,默认2
proxyType
String
代理类型 noproxy|http|https|socks5,默认noproxy
host
String
代理主机
proxyUserName
String
代理用户名
proxyPassword
String
代理密码
dynamicIpUrl
String
提取IPurl
dynamicIpChannel
String
提取IP服务商 rola|ipidea|deoveip|cloudam
isDynamicIpChangeIp
Boolean
默认true
isGlobalProxyInfo
Boolean
false
port
Int
代理端口
isIpv6
Boolean
是否是IPv6,默认false
批量修改窗口备注
POST
/browser/remark/update
Request Body
browserIds*
Array
浏览器ID数组
remark*
String
备注
通过序号批量关闭窗口
POST
/browser/close/byseqs
Request Body
seqs*
Array
要关闭的窗口序号数组,如:[101, 103, 105]
更新窗口与指纹指定字段值,支持批量修改
POST
/browser/update/partial
只传需要更新的字段即可,如需要更新name,则只传name
Request Body
ids*
Array
要更新的窗口ids集合,单个更新时,传一个id即可,如: ["abd8fd953d3641a0915865a09b8d99ba"]
browserFingerPrint*
Object
指纹对象,传入要更新的对应指纹字段即可,无调整,则放空对象{}即可
其他参数如 name
String
更新那个,传入哪个,不更新的不需要传
获取已打开窗口的进程id集合,也可以用来判断窗口是否已打开,支持批量查询
POST
/browser/pids
Request Body
ids*
Array
窗口id集合,数组类型
{
"success": true,
"data": {
"02d39dd4f9c54e40bc1ef51929d27235": 69902,
"39dd4f4e40bc1ef51929d27232sdf3ds": 84773
}
}
获取所有活着的已打开的窗口的进程ID,会自动过滤掉已死掉的进程,无参数
POST
/browser/pids/all
{
"10702539009b4d90a862c78aed2c98c9": 23122,
"20702539009b4d90a862c78aed2c98c9": 32242
}
获取活着的给定窗口的pids,会检查进程,减少进程退出,但是窗口状态没关闭的问题
POST
/browser/pids/alive
Request Body
ids*
Array
窗口id集合,数组类型
{
// Response
}
批量删除窗口,一次最多100个,彻底删除记录,包括缓存
POST
/browser/delete/ids
Request Body
ids*
Array
窗口id集合,数组类型,必传
{
// Response
}
windowbounds对象
{
"type": "box", // 排列方式,宫格 box , 对角线 diagonal
"startX": 0, // 起始X位置
"startY": 0, // 起始Y位置
"width": 500, // 宽度
"height": 300, // 高度
"col": 4, // 宫格排列时,每行列数
"spaceX": 0, // 宫格横向间距
"spaceY": 0, // 宫格纵向间距
"offsetX": 50, // 对角线横向偏移量
"offsetY": 50 // 对角线纵向偏移量
}
browserFingerPrint指纹对象
{
coreVersion: '104', // 内核版本,默认104,可选92
ostype: 'PC', // 操作系统平台 PC|Android|IOS
os: 'Win32', // 为navigator.platform值 Win32 | Linux i686 | Linux armv7l | MacIntel,当ostype设置为IOS时,设置os为iPhone,ostype为Android时,设置为 Linux i686 || Linux armv7l
version: '', //浏览器版本,建议92以上,不填则会从92以上版本随机
userAgent: '', // ua,不填则自动生成
isIpCreateTimeZone: true, // 基于IP生成对应的时区
timeZone: '', // 时区,isIpCreateTimeZone 为false时,参考附录中的时区列表
timeZoneOffset: 0, // isIpCreateTimeZone 为false时设置,时区偏移量
webRTC: '0', //webrtc 0替换|1允许|2禁止
ignoreHttpsErrors: false, // 忽略https证书错误,true|false
position: '1', //地理位置 0询问|1允许|2禁止
isIpCreatePosition: true, // 是否基于IP生成对应的地理位置
lat: '', // 经度 isIpCreatePosition 为false时设置
lng: '', // 纬度 isIpCreatePosition 为false时设置
precisionData: '', //精度米 isIpCreatePosition 为false时设置
isIpCreateLanguage: true, // 是否基于IP生成对应国家的浏览器语言
languages: '', // isIpCreateLanguage 为false时设置,值参考附录
isIpCreateDisplayLanguage: false, // 是否基于IP生成对应国家的浏览器界面语言
displayLanguages: '', // isIpCreateDisplayLanguage 为false时设置,默认为空,即跟随系统,值参考附录
openWidth: 1280, // 窗口宽度
openHeight: 720, // 窗口高度
resolutionType: '0', // 分辨率类型 0跟随电脑 | 1自定义
resolution: '1920 x 1080', // 自定义分辨率时,具体值
windowSizeLimit: true, // 分辨率类型为自定义,且ostype为PC时,此项有效,约束窗口最大尺寸不超过分辨率
devicePixelRatio: 1, // 显示缩放比例,默认1,填写时,建议 1|1.5|2|2.5|3
fontType: '2', // 字体生成类型 0系统默认|1自定义|2随机匹配
font: '', // 自定义或随机匹配时,设置的字体值,值参考附录字体
canvas: '0', //canvas 0随机|1关闭
canvasValue: null, // canvas为0随机时设置, 噪音值 10000 - 1000000
webGL: '0', //webGL图像,0随机|1关闭
webGLValue: null, // webGL为0时,随机噪音值 10000 - 1000000
webGLMeta: '0', //webgl元数据 0自定义|1关闭
webGLManufacturer: '', // webGLMeta 自定义时,webGL厂商值,建议留空会自动生成,手工改参考附录
webGLRender: '', // webGLMeta自定义时,webGL渲染值,建议留空自动生成,手工改参考附录
audioContext: '0', // audioContext值,0随机|1关闭
audioContextValue: null, // audioContext为随机时,噪音值, 1 - 100 ,关闭时默认10
mediaDevice: '0', // 媒体设备信息,0自定义|1关闭
mediaDeviceValue: null, // mediaDevice 噪音值,不填则由系统生成,填值时,参考附录
speechVoices: '0', // Speech Voices,0随机|1关闭
speechVoicesValue: null, // speechVoices为0时,随机时由系统自动生成,自定义时,参考附录
hardwareConcurrency: '4', // 硬件并发数
deviceMemory: '8', // 设备内存,1,2,4,8,不要传入大于8的值
doNotTrack: '1', // doNotTrack 0开启|1关闭
clientRectNoiseEnabled: true, // ClientRects true使用相匹配的值代替您真实的ClientRects | false每个浏览器使用当前电脑默认的ClientRects
clientRectNoiseValue: 0, // clientRectNoiseEnabled开启时随机,值 1 - 999999
portScanProtect: '0', // 端口扫描保护 0开启|1关闭
portWhiteList: '', // 端口扫描保护开启时的白名单,逗号分隔
deviceInfoEnabled: true, // 自定义设备信息,默认开启
computerName: '', // deviceInfoEnabled 为true时,设置
macAddr: '', // deviceInfoEnabled 为true时,设置
disableSslCipherSuitesFlag: false, // ssl是否禁用特性,默认不禁用,注意开启后自定义设置时,有可能会导致某些网站无法访问
disableSslCipherSuites: null, // ssl 禁用特性,序列化的ssl特性值,参考附录
enablePlugins: false, // 是否启用插件指纹
plugins: '' // enablePlugins为true时,序列化的插件值,插件指纹值参考附录
}
Last updated