通过 MoreLogin API 以编程方式启动、停止、连接和管理云浏览器环境。
云浏览器 API 会将 MoreLogin 浏览器环境运行在远端主机上。启动环境后，您可以通过 Chrome DevTools 协议（CDP）连接该环境，并使用 Puppeteer、Playwright 或 Selenium 等自动化框架进行操作。
云浏览器支持两种 API 接入方式：
| 方式 | Base URL | 适用场景 |
|---|---|---|
| 开放 API（远程） | https://api.morelogin.com | 可从任意位置访问，使用 OAuth2 鉴权 |
| 本地 API（本地） | http://127.0.0.1:40000 | 从运行 MoreLogin 客户端的本机访问 |
如需远程访问或服务端对服务端集成，请选择开放 API。 如果自动化脚本与 MoreLogin 客户端运行在同一台机器上，请选择本地 API。
鉴权详情请参阅身份验证。
| 操作 | 说明 |
|---|---|
| 启动 | 启动云浏览器环境 |
| 停止 | 停止运行中的环境，可选择强制释放 |
| 分页 | 分页查询环境，支持按名称、分组和关键词过滤 |
| 连接 | 获取运行中环境的 CDP 地址，用于接入自动化工具 |
- 使用
envId启动环境，环境进入STARTING状态。 - 轮询分页列表，直到
cloudBrowserStatus变为RUNNING。 - 连接以获取
cdpUrl，然后通过 CDP 接入 Puppeteer / Playwright / Selenium。 - 自动化任务结束后停止环境。
| 状态 | 说明 |
|---|---|
STARTING | 启动中 |
RUNNING | 运行中 |
CLOSED | 已关闭 |
连接接口会返回两个地址：
{
"code": 0,
"msg": null,
"data": {
"cdpUrl": "https://runtime1.morelogin.com:16167?token=c62fedaaac524e41a0f02fc4345d41cb",
"accessUrl": "https://official-website.morelogin.com/browser-remote?token=eyJkZXNrdG9wVXJsIjoi...ZW52SWQiOiIyMDczMzk1NDg5NzM4OTE5OTM2In0%3D&envName=P-1267&lang=en-US"
}
}| 字段 | 说明 |
|---|---|
cdpUrl | 带访问 token 的 CDP 地址，可传入 Puppeteer、Playwright 或 Selenium。 |
accessUrl | 云浏览器远程桌面页面地址，用于查看和操作会话；未配置时为空。 |
accessUrl中的token是 Base64 编码的载荷，包含桌面地址、桌面 token、过期时间以及团队、用户、成员和环境 ID。请将这两个地址视为凭据，不要对外泄露。
| API | 说明 |
|---|---|
| 云浏览器开放 API | 通过 https://api.morelogin.com 远程访问，使用 OAuth2 鉴权 |
| 云浏览器本地 API | 通过 http://127.0.0.1:40000 本地访问，使用 token 鉴权 |
注意：两套 API 提供相同的操作。本地 API 路径使用
/api/cloudbrowser/...前缀，开放 API 路径使用/cloudbrowser/...。具体路径和参数请始终参考对应的 API 参考文档。