# Chạm - Nhấp

Chạm vào một điểm trên màn hình cloud phone.
- **Điều kiện tiên quyết**: cloud phone phải đang bật và không bị thành viên khác chiếm giữ. Chỉ hỗ trợ trên Các mẫu tương thích; các mẫu thiết bị khác từ chối lệnh gọi.
- **Tọa độ**: `pos` phải chứa đúng hai giá trị, `[x, y]`. **Chúng không được đối chiếu với độ phân giải màn hình** — một điểm nằm ngoài màn hình vẫn được chuyển thẳng tới dịch vụ thiết bị.
- **Hoàn tất**: đồng bộ. `data.status` là `finish` khi thao tác đã xong, hoặc `pending` khi dịch vụ thiết bị đưa nó vào hàng đợi. Một số mẫu luôn báo `finish`. Không có endpoint nào để hỏi vòng một thao tác `pending`.
- **Thử lại**: không có cơ chế chống trùng. Hai lệnh gọi là hai lần chạm, nên thử lại mù quáng sau khi hết thời gian chờ có thể tạo thành chạm hai lần.
- **Lưu ý**: `duration` được nhận ở đây nhưng bị bỏ qua; chỉ nhấn giữ mới đọc nó.

Các mã lỗi nghiệp vụ đã ghi nhận: `33300`, `33301`, `33401`. Xem [Error Codes](../Getting%20Started/error-codes.md) để biết ý nghĩa từng mã. Mọi thao tác cũng có thể trả về các mã dùng chung.

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

## Security:

  - `Authorization` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `id` (string, required)
    ID điện thoại đám mây
    Example: 1558968155668507

  - `pos` (array, required)
    Tọa độ nhấp [x, y]. Hệ tọa độ sử dụng góc trên bên trái của màn hình làm gốc (0, 0).
    Example: [540,960]

  - `duration` (integer)
    Thời gian nhấn giữ tính bằng mili giây (dùng cho nhấn giữ). Nếu bỏ qua, thời gian mặc định sẽ được sử dụng.
    Example: 2000

## Response 200:

  - `200` (unknown)
    Thao tác thành công

## Response 200 fields (application/json):

  - `code` (integer)
    Mã trạng thái, 0 nghĩa là thành công
    Example: 0

  - `msg` (string | null)
    Thông báo phản hồi
    Example: success

  - `data` (object)

  - `data.status` (string)
    Trạng thái thực thi
    Example: finish