# Mã lỗi

Trang này liệt kê các mã lỗi phổ biến được API MoreLogin trả về.

## Định dạng phản hồi

Tất cả các phản hồi API đều tuân theo định dạng tiêu chuẩn này:

```json
{
  "code": 0,
  "msg": null,
  "data": {},
  "requestId": "unique-request-id"
}
```

| trường | Loại | Mô tả |
|  --- | --- | --- |
| `code` | số nguyên | `0` = thành công, `>0` = lỗi |
| `msg` | chuỗi | Thông báo lỗi (không có giá trị khi thành công) |
| `data` | vật thể | Dữ liệu phản hồi |
| `requestId` | chuỗi | Mã định danh yêu cầu duy nhất để khắc phục sự cố |


## Mã lỗi phổ biến

### Lỗi chung

| Mã | Mô tả | Giải pháp |
|  --- | --- | --- |
| `0` | thành công | — |
| `99001` | Thông số không hợp lệ | Kiểm tra định dạng nội dung yêu cầu và các trường bắt buộc |
| `99002` | Quyền bị từ chối | Kiểm tra quyền tài khoản của bạn |
| `99003` | Yêu cầu ngoại lệ | Vui lòng thực hiện các điều chỉnh kinh doanh cần thiết dựa trên phản hồi |
| `99004` | Nội dung yêu cầu quá lớn | Kiểm tra nội dung yêu cầu của bạn |
| `429` | Đã vượt quá giới hạn tỷ lệ | Giảm tần suất yêu cầu và thử lại sau khi bị trì hoãn |


### Lỗi hồ sơ trình duyệt (API cục bộ)

| Mã | Mô tả | Giải pháp |
|  --- | --- | --- |
| `100` | Hồ sơ đang chạy | Trước tiên hãy đóng hồ sơ bằng `/api/env/close` |
| `101` | Không tìm thấy hồ sơ | Xác minh `envId` hoặc `uniqueId` |
| `102` | MoreLogin client không chạy | Khởi động ứng dụng máy tính để bàn MoreLogin |
| `103` | Cần có khóa mã hóa | Cung cấp `encryptKey` cho hồ sơ được mã hóa |


### Lỗi điện thoại đám mây (API mở)

| Mã | Mô tả | Giải pháp |
|  --- | --- | --- |
| `200` | Điện thoại đám mây đang ngoại tuyến | Trước tiên hãy bật nguồn điện thoại đám mây |
| `201` | Cài đặt ứng dụng không thành công | Kiểm tra `appVersionId` hoặc `packageName` |
| `202` | Tải tệp lên không thành công | Xác minh URL tệp và đường dẫn đích |


## Mã trạng thái HTTP

| Trạng thái | Mô tả |
|  --- | --- |
| `200` | Yêu cầu đã được xử lý (kiểm tra trường `code` để biết kết quả kinh doanh) |
| `401` | Trái phép - mã thông báo truy cập không hợp lệ hoặc hết hạn |
| `403` | Bị cấm - không đủ quyền |
| `429` | Quá nhiều yêu cầu - vượt quá giới hạn tốc độ |
| `500` | Lỗi máy chủ nội bộ - liên hệ với bộ phận hỗ trợ |


> **Mẹo**: Luôn bao gồm `requestId` trong phản hồi khi liên hệ với bộ phận hỗ trợ để khắc phục sự cố nhanh hơn.