# Điện thoại đám mây khởi nghiệp

Bật một cloud phone.
- **Điều kiện tiên quyết**: cloud phone hiện phải đang tắt. Lệnh bị từ chối khi SKU đã ngừng bán hoặc đang bảo trì, khi máy bị thành viên khác chiếm giữ, khi proxy của nó còn đang được kiểm tra, khi tài khoản đang nợ phí hoặc máy đã bị vô hiệu hóa, khi kỳ hạn theo tháng đã hết, và khi không có sẵn cả phút miễn phí, suất đồng thời lẫn số dư dương. Một số dòng máy còn yêu cầu bản client Windows mới nhất.
- **Tác động**: đánh dấu cloud phone là đang khởi động, chiếm giữ nó cho thành viên đang gọi, và giữ một suất đồng thời hoặc bắt đầu tiêu thụ thời gian. Phản hồi cho biết cơ chế nào trong hai cơ chế đó đã được dùng.
- **Hoàn tất**: **đã tiếp nhận, chưa hoàn tất.** Hãy hỏi vòng `/cloudphone/info` cho đến khi `envStatus` là đang bật; nếu thất bại thì lý do xuất hiện ở đó dưới dạng `errorCode` và `errorMsg`. Thành viên đã cấu hình host callback còn nhận được một webhook.
- **Thử lại**: lệnh gọi thứ hai đồng thời bị từ chối thẳng thay vì xếp hàng đợi. Sau khi hết thời gian chờ, hãy đọc `/cloudphone/info` chứ đừng gửi lại.

Các mã lỗi nghiệp vụ đã ghi nhận: `33300`, `33309`, `33315`, `33316`, `33317`, `33318`, `33321`, `33322`, `33323`, `33324`, `33325`, `33346`, `33347`, `33367`, `33376`, `33407`. 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/powerOn
Version: 2026-09-05

## Request fields (application/json):

  - `id` (string, required)

  - `headless` (boolean)
    Hiển thị cửa sổ điện thoại đám mây. false: Hiển thị, true: Không hiển thị, Mặc định: true

  - `disableMoneySavingMode` (boolean)
    Tắt chế độ tiết kiệm pin, mặc định: false

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `code` (integer, required)
    Mã trả về 0: Bình thường. Các mã khác là ngoại lệ.

  - `msg` (string | null, required)
    Thông báo lỗi

  - `requestId` (string, required)
    ID yêu cầu vận hành