# Navegador na Nuvem

Inicie, pare, conecte e gerencie ambientes de navegador na nuvem programaticamente através da API do MoreLogin.

## Visão Geral

A API de Navegador na Nuvem executa um perfil de navegador do MoreLogin em um host remoto. Após iniciar um ambiente, você pode se conectar a ele pelo protocolo Chrome DevTools (CDP) e controlá-lo com frameworks de automação como Puppeteer, Playwright ou Selenium.

**O Navegador na Nuvem oferece dois métodos de acesso à API:**

| Método | Base URL | Caso de uso |
|  --- | --- | --- |
| **API Aberta** (remota) | `https://api.morelogin.com` | Acesso de qualquer lugar, autenticação OAuth2 |
| **API Local** (local) | `http://127.0.0.1:40000` | Acesso a partir da máquina que executa o cliente MoreLogin |


> Escolha a **API Aberta** se precisar de acesso remoto ou integração servidor a servidor.
Escolha a **API Local** se estiver executando a automação na mesma máquina que o cliente MoreLogin.


Para detalhes de autenticação, consulte [Autenticação](/pt/api-reference/getting-started/authentication).

## Recursos

| Operação | Descrição |
|  --- | --- |
| **Iniciar** | Inicia um ambiente de navegador na nuvem |
| **Parar** | Para um ambiente em execução, com opção de forçar a liberação |
| **Paginar** | Consulta ambientes por página com filtros de nome, grupo e palavra-chave |
| **Conectar** | Obtém o endereço CDP de um ambiente em execução para conectar ferramentas de automação |


## Fluxo de Trabalho Típico

1. **Inicie** o ambiente com `envId`. O ambiente entra no estado `STARTING`.
2. **Consulte periodicamente** a lista paginada até que `cloudBrowserStatus` seja `RUNNING`.
3. **Conecte-se** para obter o `cdpUrl` e, em seguida, conecte Puppeteer / Playwright / Selenium via CDP.
4. **Pare** o ambiente quando a automação terminar.


## Status do Ambiente

| Status | Descrição |
|  --- | --- |
| `STARTING` | Iniciando |
| `RUNNING` | Em execução |
| `CLOSED` | Encerrado |


## Detalhes da Conexão

O endpoint de conexão retorna dois endereços:

```json
{
  "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"
  }
}
```

| Campo | Descrição |
|  --- | --- |
| `cdpUrl` | Endpoint CDP com o `token` de acesso. Passe-o para Puppeteer, Playwright ou Selenium. |
| `accessUrl` | Página de desktop remoto no navegador para visualizar e controlar a sessão. Vazio se não configurado. |


> O `token` do `accessUrl` é um payload codificado em Base64 que contém a URL do desktop, o token do desktop, a validade e os IDs de equipe, usuário, membro e ambiente. Trate ambas as URLs como credenciais e não as compartilhe.


## Referência da API

| API | Descrição |
|  --- | --- |
| [API Aberta de Navegador na Nuvem](/pt/api-reference/cloud-browser/open-api) | Acesso remoto via `https://api.morelogin.com`, autenticação OAuth2 |
| [API Local de Navegador na Nuvem](/pt/api-reference/cloud-browser/local-api) | Acesso local via `http://127.0.0.1:40000`, autenticação por token |


> **Observação**: Ambas as APIs expõem as mesmas operações. Os caminhos da API Local usam o prefixo `/api/cloudbrowser/...`, enquanto os da API Aberta usam `/cloudbrowser/...`. Consulte sempre a referência específica da API para obter os caminhos e parâmetros exatos.


## Guias Relacionados

| Guia | Descrição |
|  --- | --- |
| [Autenticação](/pt/api-reference/getting-started/authentication) | Configuração de token OAuth2 (API Aberta) e autenticação por token (API Local) |
| [Início Rápido](/pt/api-reference/getting-started/quickstart) | Execute sua primeira chamada à API do MoreLogin |