# Chạm - Kéo

Kéo giữa hai đ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.
- **Lưu ý**: **Trên một số mẫu đây là cùng một hiện thực với trượt** — dịch vụ chuyển thao tác kéo thẳng sang quy trình trượt, nên trên dịch vụ thiết bị này không thể phân biệt hai thao tác. Các mẫu khác có hành động kéo riêng.
- **Hoàn tất**: đồng bộ. `data.status` là `finish` hoặc `pending`.
- **Thử lại**: không có cơ chế chống trùng; gọi lại sẽ kéo lần nữa.

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/drag
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

  - `pos1` (array, required)
    Tọa độ bắt đầu [x, y]
    Example: [540,1500]

  - `pos2` (array, required)
    Tọa độ kết thúc [x, y]
    Example: [540,500]

  - `duration` (integer)
    Thời gian vuốt/kéo tính bằng mili giây. Giá trị lớn hơn dẫn đến thao tác chậm hơn.
    Example: 300

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