AdsPower浏览器已开放Local API接口,接口列表可参考往期文章:通过Local API实现浏览器自动化

 

 

目前,AdsPower客户端最新版本(应用版本v3.3.2及以上,内核版本v2.4.2.8及以上)已支持headless配合api-key启动无界面服务并使用Local API

* 该功能仅开放给有Local API功能权限的用户使用,如需开通,可向在线客服咨询申请

 

  • headless:启动“无界面服务”的参数
  • api-key:“无界面服务”中操作Local API接口的身份凭证,一个账号对应一个api-key,支持一个账号在多设备同时操作Local API接口

 

 

如何启动无界面服务?

 

1.获取api-key


1)启动AdsPower客户端,在“账号管理-设置”

 

 

 

 

2)在“基础API接口”点击“生成api-key”

 

 

 

 

3)复制已生成的api-key

 

 

 

 

2.使用命令行命令配合api-key启动无界面服务

 

1)请确保您在AdsPower主目录中已打开了CMD或Terminal

* 在Windows设备中,目录路径通常为 "C:\Program Files (x86)\AdsPower"

 

2)命令行启动

将在AdsPower客户端已复制好的api-key复制到对应的命令行中

 

️ 注意:启动无界面服务时,支持传入的参数有

参数

是否必填

说明

--headless

值为true时,指定的是无界面服务

--api-key

无界面服务操作Local API接口的身份凭证

--api-port

指定的Local API服务端口

 

* Windows/Mac系统对应参数参考

Windows:AdsPower.exe --headless=true --api-key=XXXX  --api-port=50325

MacOS:/Applications/adsPower.app/Contents/MacOS/Adspower --args --headless=true --api-key=XXXX  --api-port=50325

 

 

3)启动成功

在命令行工具处可以看到启动成功后返回的Local API地址,如下:

 

 

 

 

有界面服务VS无界面服务

 

“有界面服务”会被限制同个账号只能在一个设备登录;“无界面服务”则不限制同个账号同时登录多个设备的场景。

 

如果有一个账号想要在多个设备上跑自动化的需求,则可以使用headless配合api-key方式使用Local API接口!

 

 

操作FAQ

 

Q:我可以在一个设备同时启动有界面和无界面服务吗?

A:不可以的。

 

Q:如果更换了api-key,用旧值启动的服务调用的api接口还能继续用吗?

A:不能,启动时系统会返回api-key失效的信息。当前操作一个账号仅能对应一个api-key,如重置了api-key,旧值将失效,需要重新设值调用。

 

Q:如何重置api-key?

A:回到客户端“账号管理-设置”界面,点击“重置api-key”获取新的api-key,重置后请注意保存新的api-key.

 

Q:如果更换了api-key,是否能对已启动的服务进行api-key的更新呢?

A:不能。需先关闭服务,重新用新的api-key启动服务。

 

Q:如何关闭服务?

A:可通过ctrl+c(CMD下)或关闭命令行窗口将服务关闭。

 

http://apidoc.adspower.net/localapi/local-api-v1.html

教程|AdsPower浏览器Local API接口和headless操作说明