# Bắt đầu nhanh

Việc bắt đầu nhanh này giả định rằng bạn đã cài đặt `ml-cli` (xem [Tải xuống và cài đặt](/vi/cli#download--installation)) và ứng dụng khách MoreLogin đang chạy cục bộ.

## 1. Kiểm tra dịch vụ

Xác nhận rằng `httpServer` cục bộ có thể truy cập được:

```bash
ml-cli status
```

Nếu MoreLogin không chạy, CLI sẽ không thành công trong quá trình phân giải cổng.

## 2. Xác thực

Nếu điểm cuối yêu cầu xác thực, hãy đăng nhập trước:

```bash
ml-cli login --api-id your-api-id --api-key your-api-key
```

Bạn cũng có thể cung cấp mã thông báo thông qua biến môi trường:

```bash
export ML_API_KEY=your-token
ml-cli env list
```

## 3. Liệt kê hồ sơ trình duyệt

Liệt kê các môi trường trình duyệt:

```bash
ml-cli env list
ml-cli env list --page-no 1 --page-size 20
ml-cli env list --env-name test
```

## 4. Bắt đầu hồ sơ trình duyệt

Bạn có thể bắt đầu một môi trường bằng `id`, `envId` hoặc `uniqueId/sn`:

```bash
ml-cli env start --id 1001
ml-cli env start --env-id 1868548141708648448
ml-cli env start --unique-id SN001
```

## 5. Tạo và chỉ định proxy

Tạo proxy trước:

```bash
ml-cli proxy create \
  --proxy-name local-http \
  --proxy-ip 127.0.0.1 \
  --proxy-port 7890 \
  --proxy-type 0 \
  --proxy-provider 0
```

Sau đó gán nó vào một môi trường:

```bash
ml-cli env set-proxy \
  --env-ids 1001 \
  --proxy-ip 127.0.0.1 \
  --proxy-port 7890 \
  --proxy-type 0 \
  --proxy-provider 0 \
  --proxy-name local-http
```

## 6. Làm việc với điện thoại đám mây

Liệt kê điện thoại đám mây:

```bash
ml-cli cloudphone list
```

Tạo điện thoại đám mây:

```bash
ml-cli cloudphone create --sku-id 10004 --quantity 1
```

Tìm nạp chi tiết:

```bash
ml-cli cloudphone info --id 123456
```

## 7. Lịch truy vấn

Liệt kê các mẫu lịch trình và nhiệm vụ:

```bash
ml-cli schedule template-market --page-no 1 --page-size 20
ml-cli schedule list --page-no 1 --page-size 20
```

Tạo tác vụ một lần:

```bash
ml-cli schedule create-once-task \
  --cloud-phone-id 123456 \
  --schedule-name once-task-demo \
  --template-id 888 \
  --template-parameter '{}'
```

## 8. Sử dụng `--json-data`

Đối với các điểm cuối có nhiều trường, việc truyền JSON thô thường nhanh hơn:

```bash
ml-cli env create-advanced \
  --json-data '{"browserTypeId":1,"operatorSystemId":1,"envName":"cli-adv-test"}'
```

Cờ CLI và `--json-data` có thể được kết hợp. Cờ rõ ràng ghi đè các khóa khớp từ tải trọng JSON:

```bash
ml-cli env set-proxy \
  --env-ids 1001 \
  --json-data '{"proxy":{"proxyProvider":"0","proxyIp":"1.1.1.1"}}' \
  --proxy-ip 127.0.0.1
```

## 9. Chuyển tới `jq`

CLI in JSON thô, hoạt động tốt với các đường dẫn shell:

```bash
ml-cli status | jq '.status'
ml-cli env processes | jq '.data[].pid'
```

## 10. Các trường hợp hư hỏng thường gặp

- `Could not detect MoreLogin port`: MoreLogin không chạy, IPC không khả dụng hoặc không cung cấp `--port`
- lỗi kinh doanh với mã thoát `0`: yêu cầu HTTP đã thành công nhưng phản hồi JSON chứa lỗi cấp ứng dụng
- `ml-cli env arrange` trên Linux: triển khai hiện tại không hỗ trợ và thoát ngay lập tức