# Criar link de conexão remota ao telefone na nuvem

Cria um link temporário de acesso pelo navegador ao telefone na nuvem (somente Open API).
- **Pré-requisitos**: o telefone deve pertencer à equipe, estar acessível ao membro que faz a chamada, estar ligado e não estar ocupado por outro membro. A API não liga o telefone automaticamente.
- **Efeito**: cada chamada cria um novo link sem solicitar credenciais de conexão nem alterar a conexão atual. Abra `data.url` no navegador ou gere um código QR com a URL completa.
- **Validade**: exatamente 5 minutos desde a criação. Visitas repetidas não consomem nem prolongam o link. Após expirar, chame a API novamente. O campo `expiredTime` não é retornado; esse prazo não indica a validade das credenciais de conexão.
- **Conexão**: cada visita bem-sucedida solicita novas credenciais e redireciona para a página de controle remoto; isso pode afetar uma conexão anterior. Uma visita que falhou pode ser repetida durante a validade restante. Criar o link não garante o sucesso da conexão posterior.
- **Proteção**: mantenha a URL completa em sigilo. A resposta inclui `Cache-Control: no-store`. Use a URL retornada sem alterações; o servidor escolhe o domínio e os parâmetros de conexão.

Erros de negócio documentados: `33300`, `33301`, `99002`. 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 /cloudphone/link
Version: 2026-09-05
Security: Authorization

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

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

  - `lang` (string)
    Idioma da página, por exemplo `zh-CN` ou `en-US`. Se omitido ou vazio, usa o idioma da solicitação; valores não compatíveis usam o padrão configurado. O idioma é incluído na URL; o parâmetro de consulta `lang` pode ser alterado para mudar o idioma da página.

## Response 200:

  - `200` (unknown)
    Sucesso. `data.url` é o link temporário de acesso pelo navegador, válido por 5 minutos.

## Response 200 fields (application/json):

  - `code` (integer, required)
    Example: 0

  - `msg` (string | null, required)
    Example: null

  - `data` (object, required)

  - `data.url` (string, required)
    URL temporária de acesso pelo navegador. Trate a URL completa como uma credencial sensível.
    Example: https://gateway.example.com/app/cloudphone/qrcodeUrl?token=0123456789abcdef0123456789abcdef&lang=en-US

  - `requestId` (string)

## Response 200 headers (application/json):

  - `Cache-Control` (string)
    Não armazene esta resposta em cache.
    Enum: "no-store"