巨象跨境指纹浏览器Local REST API

Base URL:http://127.0.0.1:39627/api

searchElement 参数各个属性值描述:

parent:要查找元素的父级元素的名称 selector:查找元素的selector语句 isXPath:selector语句是否是XPath语句 index:查找到多个元素的时候,选择第几个元素。从0开始 searchAllIframe:是否在iframe里面查找 selectorForSearchIframe:查找iframe的selector语句

环境操作

获取列表

请求地址 /environment/list

请求参数

参数类型描述
typeint列表类型,0 - 所有环境,1 - 已开启环境,2 - 未开启环境

请求参数示例

返回结果示例

启动环境

请求地址 /environment/start

请求参数

参数类型描述
environmentIdString环境id

请求参数示例

返回结果示例

关闭环境

请求地址 /environment/close

请求参数

参数类型描述
environmentIdString环境id
browserIdint浏览器id

请求参数示例

返回结果示例

浏览器操作

加载网页

请求地址 /browser/loadurl

请求参数

参数类型描述
browserIdint浏览器id
urlString要加载的网页URL
newTabbool是否打开新tab页
timeoutint加载超时时间,单位是秒

请求参数示例

返回结果示例

切换标签页

请求地址 /browser/switchtab

请求参数

参数类型描述
browserIdint浏览器id
urlString通过此URL查找第一个匹配的tab页
lastTabbool是否切换到最后一个tab页

请求参数示例

返回结果示例

关闭标签页

请求地址 /browser/closetab

请求参数

参数类型描述
browserIdint浏览器id
urlString通过此URL查找第一个匹配的tab页
closeOthersbool是否关闭除匹配到的tab之外的其他所有tab页
closeLastTabbool是否关闭最后一个tab页

请求参数示例

返回结果示例

设置cookie

请求地址 /browser/setcookie

请求参数

参数类型描述
cookieStringjson格式的cookie字符串

请求参数示例

返回结果示例

获取cookie

请求地址 /browser/getcookie

请求参数

参数类型描述
browserIdint浏览器id

|url|String|指定要获取的cookie的网站地址|= 请求参数示例

返回结果示例

获取所有cookie

请求地址 /browser/getallcookies

请求参数

参数类型描述
browserIdint浏览器id

请求参数示例

返回结果示例

清空cookie

请求地址 /browser/clearcookies

请求参数

参数类型描述
browserIdint浏览器id

请求参数示例

返回结果示例

获取截图(高级API

请求地址 /browser/getimage

请求参数

参数类型描述
browserIdint浏览器id
filePathString保存到本地的路径,图片格式为png
elementScreenshotbool是否截取元素图片
searchElementObject查找元素的条件设置

请求参数示例

返回结果示例

执行JS(高级API

请求地址 /browser/executejs

请求参数

参数类型描述
browserIdint浏览器id
jsString要执行的js
inIframebool是否在jframe里执行
selectorForIframeString查找iframe的selector语句

请求参数示例

返回结果示例

查找元素

请求地址 /browser/findelement

请求参数

参数类型描述
browserIdint浏览器id
searchElementObject查找元素的条件设置
saveElementNameString给找到的元素指定一个名称,在"抓取文本"、“设置值”等方法里可以通过设置elementName来直接使用元素

请求参数示例

返回结果示例

等待页面加载

请求地址 /browser/pageloadwait

请求参数

参数类型描述
browserIdint浏览器id
searchElementObject查找元素的条件设置
loopint循环次数
sleepString每次循环的间隔时间,单位是秒

请求参数示例

返回结果示例

抓取特殊文本

请求地址 /browser/scrapespecialtext

请求参数

参数类型描述
browserIdint浏览器id
specialTextint特殊文本类型,0 - 网页源码,1 - 网页标题,2 - 网页Body内容,3 - 网页URL

请求参数示例

返回结果示例

抓取文本

请求地址 /browser/scrapeonetext

请求参数

参数类型描述
browserIdint浏览器id
elementNameString在使用“查找元素”和“等待页面加载”方法后查找到的元素的名称,使用searchElement的时候设置为null
searchAllIframebool是否在所有iframe里查找,与elementName一起使用
searchElementObject查找元素的条件设置。使用elementName的时候设置为null
propertyString属性名称

请求参数示例

返回结果示例

抓取多个文本(高级API

请求地址 /browser/scrapesometext

请求参数

参数类型描述
browserIdint浏览器id
searchElementObject查找元素的条件设置
propertyString属性名称

请求参数示例

返回结果示例

设置值

请求地址 /browser/setvalue

请求参数

参数类型描述
browserIdint浏览器id
elementNameString在使用“查找元素”和“等待页面加载”方法后查找到的元素的名称,使用searchElement的时候设置为null
searchAllIframebool是否在所有iframe里查找,与elementName一起使用
searchElementObject查找元素的条件设置。使用elementName的时候设置为null
propertyString属性名称
valueString要设置的值

请求参数示例

返回结果示例

模拟输入(高级API

请求地址 /browser/keystrokesemulation

请求参数

参数类型描述
browserIdint浏览器id
textString输入的文本
isSpecialKeybool是否输入特殊按键
specialKeyint特殊按键,0 - TAB,1 - ENTER,2 - UP,3 - DOWN,4 - LEFT,5 - RIGHT,6 - HOME,7 - END,8 - PAGE UP,9 - PAGE DOWN,10 - BACKSPACE,11 - DELETE,12 - ESC
sendTimesint特殊按键输入次数
minIntervalint输入每个字符的最小间隔事件,单位是毫秒
maxIntervalint输入每个字符的最大间隔事件,单位是毫秒

请求参数示例

返回结果示例

元素操作

请求地址 /browser/elementoperate

请求参数

参数类型描述
browserIdint浏览器id
elementNameString在使用“查找元素”和“等待页面加载”方法后查找到的元素的名称,使用searchElement的时候设置为null
searchAllIframebool是否在所有iframe里查找,与elementName一起使用
searchElementObject查找元素的条件设置。使用elementName的时候设置为null
operateTypeint操作类型,0 - Event,执行元素的eventName事件,1 - Click,2 - DoubleClick,3 - MouseClick,4 - MouseRightClick,5 - MouseDoubleClick,6 - MouseMove,7 - Touch,8 - ScrollTop,9 - ScrollBottom
eventNameString事件名称,比如click,focus。operateType为0的时候必填
moveTimeintoperateType为MouseMove时的移动持续时间,单位为秒

请求参数示例

返回结果示例