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

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

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

headless：启动“无界面服务”的参数

api-key：“无界面服务”中操作Local API接口的身份凭证，一个账号对应一个api-key，支持一个账号在多设备同时操作Local API接口

如何启动无界面服务？

• 一、 获取api-key

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

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

3）复制已生成的api-key

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

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

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

2）命令行启动

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

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

* 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下)或关闭命令行窗口将服务关闭。