# Thực thi lệnh shell

Chạy một lệnh shell trên cloud phone và trả về đầu ra của nó.
- **Đ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ữ.
- **Tác động**: hoàn toàn do lệnh quyết định. MoreLogin không lưu gì và **không áp dụng danh sách lệnh được phép cũng như giới hạn độ dài nào**; quyền hạn mà lệnh chạy dưới đó do dịch vụ thiết bị quy định. Nếu lệnh cần root, hãy bật root toàn cục riêng.
- **Hoàn tất**: đồng bộ — `data` là đầu ra của lệnh, không phải một task ID.
- **Thử lại**: không có bản ghi thực thi nào để tra cứu, nên khi hết thời gian chờ thì kết quả vẫn chưa xác định. Chỉ thử lại những lệnh mà bạn biết chắc là an toàn khi chạy hai lần.

Các mã lỗi nghiệp vụ đã ghi nhận: `33300`, `33301`. 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/exeCommand
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)
    ID cloud phone

  - `command` (string, required)
    Lệnh shell cần chạy

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    Mã phản hồi: 0 biểu thị thành công, >0 biểu thị thất bại

  - `data` (string, required)
    Thông tin phản hồi

  - `msg` (string | null, required)
    Thông báo phản hồi: Sẽ có thông báo lỗi được trả về khi mã lớn hơn 0.

  - `requestId` (string)
    Định danh yêu cầu duy nhất; hãy cung cấp khi liên hệ hỗ trợ