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