# Дотик - Натискання

Натискає точку на екрані хмарного телефона.
- **Передумови**: хмарний телефон повинен бути увімкнений і не може бути зайнятий іншим учасником команди. Підтримується лише на сумісних моделях; решта Сервісів відхиляють виклик.
- **Координати**: `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