# Toque - Deslizar

Desliza entre dois pontos da tela do Cloud Phone.
- **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Compatível apenas com modelos compatíveis; os demais modelos rejeitam a chamada.
- **Valores**: `pos1` é o ponto inicial e `pos2` o final, cada um exatamente `[x, y]`. `duration` é o tempo do gesto em milissegundos, limitado a 60000; Em alguns modelos o padrão é 300 ms e o caminho é interpolado em cinco eventos de movimento intermediários.
- **Conclusão**: sincrônica. `data.status` é `finish` ou `pending`.
- **Nova tentativa**: não há deduplicação; uma chamada repetida desliza novamente.

Erros de negócio documentados: `33300`, `33301`, `33401`. 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/touch/swipe
Version: 2026-09-05

## Request fields (application/json):

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

  - `pos1` (array, required)
    Coordenadas de início [x, y]
    Example: [540,1500]

  - `pos2` (array, required)
    Coordenadas de fim [x, y]
    Example: [540,500]

  - `duration` (integer)
    Duração do deslizamento/arrasto em milissegundos. Um valor maior resulta em uma ação mais lenta.
    Example: 300

## Response 200:

  - `200` (unknown)
    Operação bem-sucedida

## Response 200 fields (application/json):

  - `code` (integer)
    Código de status, 0 significa sucesso
    Example: 0

  - `msg` (string | null)
    Mensagem de resposta
    Example: success

  - `data` (object)

  - `data.status` (string)
    Status de execução
    Example: finish