# Касание - Нажатие

Нажимает точку на экране облачного телефона.
- **Предварительные условия**: облачный телефон должен быть включён и не должен быть занят другим участником команды. Поддерживается только на совместимых моделях; остальные Сервисы отклоняют вызов.
- **Координаты**: `pos` должен содержать ровно два значения, `[x, y]`. **Они не сверяются с разрешением экрана** — точка за пределами экрана передаётся Сервису как есть.
- **Завершение**: синхронное. `data.status` равен `finish`, когда жест выполнен, или `pending`, когда Сервис поставил его в очередь. Некоторые модели всегда сообщают `finish`. Эндпоинта для опроса жеста в состоянии `pending` нет.
- **Повтор**: дедупликации нет. Два вызова — это два нажатия, поэтому слепой повтор после таймаута может дать двойное нажатие.
- **Примечание**: `duration` здесь принимается, но игнорируется; его читает только долгое нажатие.

Задокументированные бизнес-ошибки: `33300`, `33301`, `33401`. Значения кодов см. в [Error Codes](../Getting%20Started/error-codes.md). Любая операция может дополнительно вернуть общие коды.

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

## Request fields (application/json):

  - `id` (string, required)
    ID облачного телефона
    Example: 1558968155668507

  - `pos` (array, required)
    Координаты нажатия [x, y]. Система координат использует левый верхний угол экрана как начало координат (0, 0).
    Example: [540,960]

  - `duration` (integer)
    Длительность нажатия в миллисекундах (используется для длительного нажатия). Если не указано, используется значение по умолчанию.
    Example: 2000

## Response 200:

  - `200` (unknown)
    Операция выполнена успешно

## Response 200 fields (application/json):

  - `code` (integer)
    Код статуса, 0 означает успех
    Example: 0

  - `msg` (string | null)
    Сообщение ответа
    Example: success

  - `data` (object)

  - `data.status` (string)
    Статус выполнения
    Example: finish