# Início rápido

Comece a usar a API MoreLogin em 5 minutos.

## Automação do navegador (API local)

**Cenário:** Crie um perfil de navegador, inicie-o, conecte-se via Puppeteer para executar um script e, em seguida, interrompa-o.

### Pré-requisitos

- Aplicativo de desktop MoreLogin **v2.15.0+** instalado e em execução localmente.
- Marionetista instalado (`npm i puppeteer-core`).


### Etapa 1: crie um perfil de navegador

```bash
curl -X POST "http://127.0.0.1:40000/api/env/create/quick" \
  -H "Content-Type: application/json" \
  -d '{
    "browserTypeId": 1,
    "operatorSystemId": 1,
    "quantity": 1
  }'
```

*Este endpoint retorna `data` como um array com os IDs dos perfis criados. Use `data[0]` como `envId` nas etapas seguintes (por exemplo, `1993244721490239488`). IDs de recursos são strings decimais.*

### Etapa 2: inicie o perfil e obtenha a porta de depuração

```bash
curl -X POST "http://127.0.0.1:40000/api/env/start" \
  -H "Content-Type: application/json" \
  -d '{"envId": "1993244721490239488"}'
```

*A resposta incluirá `debugPort` (por exemplo, `12345`).*

### Etapa 3: conectar o Puppeteer (Node.js)

```javascript
const puppeteer = require('puppeteer-core');

(async () => {
  const browser = await puppeteer.connect({
    browserURL: 'http://127.0.0.1:12345'
  });
  const page = await browser.newPage();
  await page.goto('https://www.morelogin.com');
  console.log(await page.title());
  await browser.disconnect();
})();
```

### Etapa 4: interromper o perfil

```bash
curl -X POST "http://127.0.0.1:40000/api/env/close" \
  -H "Content-Type: application/json" \
  -d '{"envId": "1993244721490239488"}'
```

## Gerenciamento de telefone em nuvem (API aberta)

**Cenário:** crie rapidamente um telefone na nuvem, inicie-o, instale um aplicativo e acione uma programação de RPA.

### Pré-requisitos

- ID da API e chave da API no painel MoreLogin.
- As etapas 1–3 funcionam em uma conta nova. A etapa 4 exige pelo menos um aplicativo na biblioteca da equipe e a etapa 5 pelo menos um modelo de RPA; nenhum dos dois é criado pela API, portanto prepare-os no painel se as consultas retornarem vazias.


### Etapa 1: Obtenha o token de acesso

```bash
curl -X POST "https://api.morelogin.com/oauth2/token" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_API_ID",
    "client_secret": "YOUR_API_KEY",
    "grant_type": "client_credentials"
  }'
```

*Salve o `access_token` da resposta.*

### Etapa 2: criar um telefone na nuvem

```bash
curl -X POST "https://api.morelogin.com/cloudphone/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "skuId": "10002",
    "quantity": 1
  }'
```

*Salve `data[0]` da resposta como ID do Cloud Phone. IDs de recursos são strings decimais.*

### Etapa 3: ligar o Cloud Phone

```bash
curl -X POST "https://api.morelogin.com/cloudphone/powerOn" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{"id": "1673823102599682"}'
```

*A inicialização é assíncrona. Uma resposta bem-sucedida apenas aceita a solicitação; aguarde o dispositivo ficar pronto antes de enviar comandos que exijam estado online.*

### Etapa 4: instale um aplicativo

Os aplicativos são instalados a partir da biblioteca da equipe, então consulte primeiro o que ela contém:

```bash
curl -X POST "https://api.morelogin.com/cloudphone/app/page" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{"pageNum": 1, "pageSize": 10}'
```

*Use `data.dataList[0].appVersionList[0].id` como `appVersionId` — as versões vêm com a mais recente primeiro. O `id` do nível do aplicativo não é o que `install` espera. Se `data.dataList` estiver vazio, envie um aplicativo no painel MoreLogin: não há API para popular a biblioteca.*

Instale por `appVersionId` ou por `packageName` mais `versionCode` quando você souber apenas o pacote:

```bash
curl -X POST "https://api.morelogin.com/cloudphone/app/install" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "id": "1673823102599682",
    "appVersionId": "1672940217990530"
  }'
```

### Etapa 5: execute uma programação RPA

Liste seus modelos e escolha o `id` que deseja executar:

```bash
curl -X POST "https://api.morelogin.com/cloudphone/rpa/template/personal/page" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{"pageNo": 1}'
```

*Use `data.dataList[0].id` como `templateId` abaixo. Os modelos são criados no painel ou obtidos no mercado; a API apenas os lista e executa.*

```bash
curl -X POST "https://api.morelogin.com/cloudphone/rpa/onceTask/save" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "cloudPhoneId": "1673823102599682",
    "scheduleName": "Daily Login Task",
    "templateId": "987654321"
  }'
```

## O que vem a seguir?

| Objetivo | Vá para |
|  --- | --- |
| Referência completa da API do perfil do navegador | [API do navegador](/pt/api-reference/browser/local-api) |
| Referência completa da API Cloud Phone | [API Cloud Phone](/pt/api-reference/cloud-phone/open-api) |
| Conecte-se via ADB | [Guia de conexão ADB](/pt/api-reference/cloud-phone/adb) |