# Toque - Clic

Toca un punto de la pantalla del Cloud Phone.
- **Requisitos previos**: el teléfono debe estar encendido y no puede estar retenido por otro miembro del equipo. Compatible solo con modelos compatibles; los demás modelos rechazan la llamada.
- **Coordenadas**: `pos` debe contener exactamente dos valores, `[x, y]`. **No se comprueban contra la resolución de la pantalla**: un punto fuera de pantalla se transmite tal cual al servicio.
- **Finalización**: sincrónica. `data.status` es `finish` cuando el gesto terminó, o `pending` cuando el servicio lo puso en cola. Algunos modelos siempre informan `finish`. No hay endpoint para consultar un gesto `pending`.
- **Reintentos**: no hay deduplicación. Dos llamadas son dos toques, así que un reintento a ciegas tras un timeout puede provocar un doble toque.
- **Nota**: aquí se acepta `duration` pero se ignora; solo la pulsación larga lo lee.

Errores de negocio documentados: `33300`, `33301`, `33401`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para el significado de cada código. Cualquier operación puede devolver además los códigos comunes.

Endpoint: POST /api/cloudphone/touch/click
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)
    ID del teléfono en la nube
    Example: 1558968155668507

  - `pos` (array, required)
    Coordenadas de toque [x, y]. El sistema de coordenadas utiliza la esquina superior izquierda como origen (0, 0).
    Example: [540,960]

  - `duration` (integer)
    Duración de la pulsación en milisegundos (usado para pulsación larga). Si se omite, se usa la duración predeterminada.
    Example: 2000

## Response 200:

  - `200` (unknown)
    Operación exitosa

## Response 200 fields (application/json):

  - `code` (integer)
    Código de estado, 0 significa éxito
    Example: 0

  - `msg` (string | null)
    Mensaje de respuesta
    Example: success

  - `data` (object)

  - `data.status` (string)
    Estado de ejecución
    Example: finish