# Chạm - Vuốt

Trượt 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.
- **Giá trị**: `pos1` là điểm bắt đầu và `pos2` là điểm kết thúc, mỗi điểm đúng dạng `[x, y]`. `duration` là thời gian thao tác tính theo milligiây, tối đa 60000; Trên một số mẫu mặc định là 300 ms và đường đi được nội suy thành năm sự kiện di chuyển trung gian.
- **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ẽ trượt 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 /api/cloudphone/touch/swipe
Version: 2026-09-05

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