# Khởi chạy ứng dụng

Mở một ứng dụng đã cài trên 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ữ.
- **Hoàn tất**: phản hồi xác nhận lệnh đã tới dịch vụ thiết bị, không phải ứng dụng đã ở tiền cảnh. Không có endpoint nào báo ứng dụng đang chạy: hãy kiểm chứng bằng ảnh chụp màn hình hoặc một lệnh shell.
- **Thử lại**: không có cơ chế chống trùng; gọi lại sẽ gửi lệnh một lần nữa.

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/app/start
Version: 2026-09-05

## Request fields (application/json):

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

  - `packageName` (string, required)
    Tên gói ứng dụng

## Response 200:

  - `200` (unknown)
    Thành công. `data` luôn là null với thao tác này; kết quả được thể hiện qua `code`.

## Response 200 fields (application/json):

  - `code` (integer)

  - `msg` (string | null)

  - `data` (null)

  - `requestId` (string)