# Toque - Clique

Toca em um ponto 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.
- **Coordenadas**: `pos` precisa conter exatamente dois valores, `[x, y]`. **Eles não são verificados contra a resolução da tela** — um ponto fora da tela é repassado como está ao serviço.
- **Conclusão**: sincrônica. `data.status` é `finish` quando o gesto terminou, ou `pending` quando o serviço o enfileirou. Alguns modelos sempre informam `finish`. Não há endpoint para consultar um gesto `pending`.
- **Nova tentativa**: não há deduplicação. Duas chamadas são dois toques, então uma repetição às cegas depois de um timeout pode gerar um toque duplo.
- **Observação**: aqui `duration` é aceito mas ignorado; somente o toque longo o lê.

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/click
Version: 2026-09-05

## Request fields (application/json):

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

  - `pos` (array, required)
    Coordenadas de toque [x, y]. O sistema de coordenadas usa o canto superior esquerdo como origem (0, 0).
    Example: [540,960]

  - `duration` (integer)
    Duração da pressão em milissegundos (usado para pressão longa). Se omitido, a duração padrão é usada.
    Example: 2000

## 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