HTTP模式

• http模式仅支持v3.13.0.1以上版本，请前往官网下载客户端最新版本【下载Hubstudio最新版】

• 操作前，请先打开客户端获取帐号验证所需的信息并购买坐席。具体见【获取app_id、app_secret、groupCode】

1.命令行唤起hubstudio

1.1.以管理员身份运行CMD或者PowerShell，并确保终端在hubstudio主目录打开，或已进入hubstudio主路径

• cmd运行以下语句

hubstudio_connector.exe --server_mode=http --threads=20 --http_port=6873 --app_id=XXXXX --group_code=XXXXX --app_secret=XXXXX

• PowerShell运行以下语句

.\hubstudio_connector.exe --server_mode=http --http_port=6873 --app_id=XXXXX --group_code=XXXXX --app_secret=XXXXX

1.2.启动成功过后在命令行工具可以看到API地址

• 若参数带入app_id、group_code、app_secret，则在右下角的托盘菜单看见Hubstudio软件图标，标明已登入hubstudio，可以调用接口运行脚本

• 若未带入app_id、group_code、app_secret参数，可在后续通过登录帐号接口登录客户端。见接口文档。

1.3.CLI命令行参数介绍

  --client_path 	[可选]
    HubStudio程序路径(默认当前路径)

  --server_mode 	[必选]
    服务启动模式, http

   --http_port 	[必选]
    http连接端口 (default 6873)
    
   --app_id 	[可选, 可在后续通过接口登录]
    用户凭证appId
    
   --app_secret 	[app_id填写时必选]
    用户凭证appSecret
    
  --group_code 	[app_id填写时必选]
    团队id

  --remote_debugging
    远程调试

  --line_setting int
    API线路设置, 0默认线路 1国内线路 2海外线路, 默认-1跟随客户端线路设置 (default -1)

  --timeout int
    客户端接口请求超时时间(秒) (default 600)

  --threads
    如threads=xx，xx为支持的并发数，范围为1~99，如： hubstudio_connector.exe --server_mode=http --threads=20；

  --version, -v   
    显示版本号

  --heartbeat_timeout int      
    客户端心跳连接超时(秒) (default 180)

  --open_wait_sec int    
    打开客户端前等待时间(秒) (default 180)

2.关闭服务并释放坐席

• 可通过ctrl+c或关闭命令行窗口将服务关闭，此时坐席会自动释放。如通过任务管理器等强制关闭, 则 坐席将在5分钟后释放

3.接口说明

3.1.帐号登录：启动客户端

3.2.浏览器环境：打开环境、关闭环境

3.3.环境管理：获取环境列表、创建环境、更新环境、更新环境代理、删除环境、导入cookie、导出cookie、获取随机UA

3.4.分组管理：获取分组列表、创建分组、删除分组

4.使用自动化工具

前提使用webdriver需要先打开环境，并获取环境的调试端口。

4.1 webdriver：
执行WebdriverHandler的get_driver方法，传入环境的调试端口，获取webdriver，然后运行自己的脚本即可。

4.2 playwright：
执行PlaywrightHandler的getbrowsercontext方法，传入环境的调试端口，获取playwright浏览器会话，然后运行自己的脚本即可。

使用示例见【点击查看脚本示例】