# Iniciar aplicativo

Inicia um app instalado em um Cloud Phone.
- **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe.
- **Conclusão**: a resposta confirma que o comando chegou ao serviço, não que o app está em primeiro plano. Não existe endpoint que informe o app em execução: verifique com uma captura de tela ou um comando de shell.
- **Nova tentativa**: não há deduplicação; uma chamada repetida despacha o comando novamente.

Erros de negócio documentados: `33300`, `33301`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Endpoint: POST /api/cloudphone/app/start
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)
    ID do telefone na nuvem

  - `packageName` (string, required)
    Nome do pacote do aplicativo

## Response 200:

  - `200` (unknown)
    Sucesso. `data` é sempre null nesta operação; o resultado é informado por `code`.

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (null)

  - `requestId` (string)