# API cục bộ Điện thoại đám mây Quản lý các phiên bản điện thoại đám mây thông qua API cục bộ MoreLogin. URL cơ sở: http://127.0.0.1:40000. API cục bộ chạy trên máy tính của bạn cùng với ứng dụng desktop MoreLogin. Tất cả yêu cầu phải xuất phát từ cùng một máy. Version: 1.0.0 ## Servers MoreLogin Local endpoint ``` http://127.0.0.1:40000 ``` ## Security ## Download OpenAPI description [API cục bộ Điện thoại đám mây](https://guide.morelogin.com/_bundle/@l10n/vi/API%20Reference/Cloud%20Phone/local-api.yaml) ## Cloud Phone Management ### Lấy danh sách hồ sơ điện thoại đám mây - [POST /api/cloudphone/page](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/pageusingpost.md) ### Tạo hồ sơ điện thoại đám mây - [POST /api/cloudphone/create](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/createusingpost.md) ### Điện thoại đám mây khởi nghiệp - [POST /api/cloudphone/powerOn](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/poweronusingpost.md) ### Tắt điện thoại đám mây - [POST /api/cloudphone/powerOff](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/poweroffusingpost.md) ### Chỉnh sửa cấu hình điện thoại đám mây - [POST /api/cloudphone/edit/batch](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/editbatchusingpost.md) ### Thiết lập proxy điện thoại đám mây - [POST /api/cloudphone/setProxy](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/setproxy.md): Thiết lập cấu hình proxy cho một hoặc nhiều điện thoại đám mây. Hỗ trợ liên kết trực tiếp proxyId, hoặc thêm/sửa đổi các tham số proxy chi tiết. Định dạng payload yêu cầu giống hệt với cấu hình proxy của trình duyệt và các thiết lập được áp dụng ngay lập tức. ### Xóa hồ sơ điện thoại đám mây - [POST /api/cloudphone/delete/batch](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/deleteusingpost.md) ### Điện thoại đám mây mới chỉ với một cú nhấp chuột - [POST /api/cloudphone/newMachine](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/onenewusingpost.md) ### Thông tin chi tiết về điện thoại đám mây - [POST /api/cloudphone/info](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/infousingpost.md) ### Lấy thông tin chi tiết điện thoại đám mây bằng AndroidId - [POST /api/cloudphone/queryByAndroidId](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/querybyandroidid.md): Truy vấn ID điện thoại đám mây được liên kết với một androidId cụ thể trong nhóm hiện tại. Trả về ID điện thoại đám mây duy nhất nếu tìm thấy. ### Bật hoặc tắt ROOT toàn cục - [POST /api/cloudphone/enableRoot](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/enableroot.md): Bật hoặc tắt quyền ROOT toàn cục ở cấp hệ thống trên một điện thoại đám mây duy nhất. ### Chụp màn hình điện thoại đám mây - [POST /api/cloudphone/screenCap](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/screencap.md): Lấy ảnh chụp màn hình thời gian thực của phiên bản điện thoại đám mây được chỉ định. Hỗ trợ trả về một URL tạm thời đã ký kèm theo dấu thời gian hết hạn. ### Chụp màn hình điện thoại đám mây (phản hồi base64) - [POST /api/cloudphone/screenCapBase64](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/screencapbase64.md): Lấy ảnh chụp màn hình thời gian thực của phiên bản điện thoại đám mây được chỉ định. Hiện tại chỉ hỗ trợ Android 12 và Android 15. ### Truy vấn danh sách thương hiệu và mẫu mã - [POST /api/cloudphone/brand/models](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/cloud-phone-management/paths/~1api~1cloudphone~1brand~1models/post.md): Truy vấn danh sách các thương hiệu và mẫu máy có sẵn cho phiên bản Android đã cho. ## ADB ### Cập nhật trạng thái ADB của điện thoại đám mây - [POST /api/cloudphone/updateAdb](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/adb/updateadbusingpost.md) ### Truy vấn hàng loạt thông tin ADB - [POST /api/cloudphone/batchAdbInfo](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/adb/batchadbinfo.md): Truy vấn hàng loạt thông tin kết nối ADB của điện thoại đám mây. - Danh sách envIds hỗ trợ tối đa 200 mục. - Hỗ trợ các truy vấn hỗn hợp giữa các nhà cung cấp wuin và arm; API sẽ tự động nhóm theo nhà cung cấp và hợp nhất kết quả. - Thông tin ADB chỉ khả dụng khi điện thoại được bật nguồn (envStatus >= 4); không thể truy vấn khi tắt nguồn hoặc đang khởi động. ### Thực thi lệnh shell - [POST /api/cloudphone/exeCommand](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/adb/executeshellcommand.md) ## Files ### Đang tải lên tệp - [POST /api/cloudphone/uploadFile](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/files/fileuploadusing.md) ### Lấy URL tệp tải lên tạm thời - [POST /api/cloudphone/upload/file/signedUrl](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/files/paths/~1api~1cloudphone~1upload~1file~1signedurl/post.md): Tải lên các tệp tạm thời thông qua giao diện này, và hệ thống sẽ tự động xóa chúng sau 7 ngày. ### Tải lên tệp cho URL - [POST /api/cloudphone/upload/file](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/files/paths/~1api~1cloudphone~1upload~1file/post.md) ### Tải lên kết quả tập tin - [POST /api/cloudphone/upload/file/result](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/files/paths/~1api~1cloudphone~1upload~1file~1result/post.md) ### Tải xuống tập tin - [POST /api/cloudphone/download](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/files/paths/~1api~1cloudphone~1download/post.md) ### Kết quả tải xuống tệp - [POST /api/cloudphone/download/result](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/files/paths/~1api~1cloudphone~1download~1result/post.md) ### Đặt hộp chìa khóa - [POST /api/cloudphone/setKeyBox](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/files/paths/~1api~1cloudphone~1setkeybox/post.md) ## Apps ### Cài đặt ứng dụng trên điện thoại đám mây - [POST /api/cloudphone/app/install](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/apps/paths/~1api~1cloudphone~1app~1install/post.md) ### Lấy danh sách ứng dụng APP - [POST /api/cloudphone/app/page](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/apps/paths/~1api~1cloudphone~1app~1page/post.md): Lấy danh sách ứng dụng APP ### Danh sách ứng dụng của nhóm - [POST /api/cloudphone/team/app/page](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/apps/paths/~1api~1cloudphone~1team~1app~1page/post.md): Lấy danh sách các ứng dụng của nhóm. ### Truy vấn danh sách ứng dụng đã cài đặt - [POST /api/cloudphone/app/installedList](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/apps/paths/~1api~1cloudphone~1app~1installedlist/post.md): Truy vấn danh sách các ứng dụng đã cài đặt trên điện thoại đám mây ### Khởi chạy ứng dụng - [POST /api/cloudphone/app/start](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/apps/paths/~1api~1cloudphone~1app~1start/post.md): Khởi chạy ứng dụng đã cài đặt trên điện thoại đám mây ### Khởi động lại ứng dụng - [POST /api/cloudphone/app/restart](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/apps/paths/~1api~1cloudphone~1app~1restart/post.md) ### Dừng ứng dụng - [POST /api/cloudphone/app/stop](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/apps/paths/~1api~1cloudphone~1app~1stop/post.md) ### Gỡ cài đặt ứng dụng - [POST /api/cloudphone/app/uninstall](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/apps/paths/~1api~1cloudphone~1app~1uninstall/post.md) ### Bật ROOT ứng dụng - [POST /api/cloudphone/app/openRoot](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/apps/appopenroot.md): Bật quyền ROOT cho một gói ứng dụng cụ thể trên một điện thoại đám mây duy nhất. ### Đặt Ẩn ứng dụng Trợ năng - [POST /api/cloudphone/app/setHideAccessibilityApp](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/apps/paths/~1api~1cloudphone~1app~1sethideaccessibilityapp/post.md): Chỉ hỗ trợ Android 13, Android 14 và Android 15A. ## Schedules ### Nhận các trang mẫu thị trường - [POST /api/cloudphone/rpa/template/market/page](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/schedules/paths/~1api~1cloudphone~1rpa~1template~1market~1page/post.md): Mẫu thị trường Lịch trình truy vấn, tên mẫu hỗ trợ truy vấn mờ. ### Tải các trang mẫu cá nhân - [POST /api/cloudphone/rpa/template/personal/page](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/schedules/paths/~1api~1cloudphone~1rpa~1template~1personal~1page/post.md): Mẫu thị trường Lịch trình truy vấn, tên mẫu hỗ trợ truy vấn mờ. ### Lấy danh sách lịch trình - [POST /api/cloudphone/rpa/task/page](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/schedules/paths/~1api~1cloudphone~1rpa~1task~1page/post.md) ### Tạo lịch trình một lần - [POST /api/cloudphone/rpa/onceTask/save](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/schedules/paths/~1api~1cloudphone~1rpa~1oncetask~1save/post.md): Lưu điện thoại đám mây một lần theo lịch trình tác vụ. Thông số kỹ thuật tham số templateParameter 1. __Nguồn tham số__ Các khóa tham số phải được trích xuất từ trường parameter được trả về bởi các API sau: - Lấy các trang mẫu thị trường - Lấy các trang mẫu Cá nhân 2. __Cấu trúc dữ liệu__ - Gửi tham số ở định dạng đối tượng JSON: {"key1": "value1", "key2": "value2"} - Giá trị tham số cuối cùng phải được giải mã theo logic nghiệp vụ trước khi sử dụng 3. __Các loại tham số thông dụng__ Đối với các loại tham số sau, hãy truyền trực tiếp các giá trị ở định dạng tương ứng: - chuỗi: {"name": "John"} - số thập phân / số: {"amount": 100.50} - boolean: {"enabled": true} 4. __Tham số loại phương tiện__ Đối với các tham số phương tiện như hình ảnh (pic) hoặc video (video), ngoài thông tin cơ bản, phải bao gồm một khóa cố định "__Extra__". Ví dụ định dạng: json { "__Extra__": { "pic": { "name": "pic_name", "size": 204800 }, "video": { "name": "video_name", "size": 204800000 } }, "pic": "https://get.morelogin.com/prod/cloudPhoneTaskVideo/1556061681934880/1c62314c7e2b4d298abe8d5452d7c050/test.png", "video": "https://get.morelogin.com/pre/cloudPhoneTaskVideo/1542431036481556/4c4fed83685345ae8f1505fbe0c2f123/baby.mp4" } 5. __Ví dụ cấu hình tham số__ Ví dụ sau đây minh họa cách cấu hình tham số templateParameter khi lưu gói cước bằng cách sử dụng mẫu thị trường: - __Bước 1: Truy xuất tham số mẫu__ Gọi API mẫu thị trường: GET /api/cloudphone/rpa/template/market/page Trích xuất trường parameter từ phản hồi, ví dụ: json "parameter": "{\"videoDownloadUrl\":{\"type\":\"video\",\"extra\":{\"name\":\"Select Video\",\"type\":\"video\",\"required\":true,\"defaultValue\":{\"enabled\":false},\"index\":1,\"sizeLimit\":{\"value\":200,\"unit\":\"MB\"},\"formatType\":[\"mp4\",\"mov\"]}},\"videoDescription\":{\"type\":\"string\",\"extra\":{\"name\":\"Video Caption\",\"type\":\"string\",\"required\":false,\"charValid\":{\"enabled\":true,\"value\":1000},\"multiline\":{\"enabled\":true,\"value\":3},\"defaultValue\":{\"enabled\":false},\"index\":2}},\"coverUrl\":{\"type\":\"image\",\"extra\":{\"name\":\"Cover Image\",\"type\":\"image\",\"required\":false,\"defaultValue\":{\"enabled\":false},\"index\":3,\"sizeLimit\":{\"value\":5,\"unit\":\"MB\"},\"formatType\":[\"jpg\",\"png\",\"jpeg\"]}},\"enableAIGC\":{\"type\":\"boolean\",\"extra\":{\"name\":\"AI Label\",\"type\":\"boolean\",\"required\":false,\"defaultValue\":{\"enabled\":false},\"index\":4}},\"productId\":{\"type\":\"string\",\"extra\":{\"name\":\"Product ID\",\"type\":\"string\",\"required\":false,\"charValid\":{\"enabled\":true,\"value\":50},\"placeholder\":\"Product ID only supports digits, with a maximum of 50 ký tự.\",\"giá trị mặc định\":{\"đã bật\":false},\"chỉ mục\":5}},\"tiêu đề sản phẩm\":{\"loại\":\"chuỗi\",\"thêm\":{\"tên\":\"Tiêu đề sản phẩm\",\"loại\":\"chuỗi\",\"bắt buộc\":false,\"ký tự hợp lệ\":{\"đã bật\":true,\"giá trị\":30},\"giá trị mặc định\":{\"đã bật\":false},\"chỉ mục\":6}},\"lấy khách hàng tiềm năng\":{\"loại\":\"boolean\",\"thêm\":{\"tên\":\"Lấy Khách hàng tiềm năng\",\"type\":\"boolean\",\"required\":false,\"defaultValue\":{\"enabled\":false},\"index\":7}},\"comment\":{\"type\":\"string\",\"extra\":{\"name\":\"Comment\",\"type\":\"string\",\"required\":false,\"charValid\":{\"enabled\":true,\"value\":200},\"multiline\":{\"enabled\":true,\"value\":3},\"defaultValue\":{\"enabled\":false},\"index\":8}}}" - __Bước 2: Xây dựng JSON tham số__ Xây dựng đối tượng JSON theo yêu cầu của tham số: json { "__Extra__": { "videoDownloadUrl": { "name": "video_name.mp4", "size": 204800000 } }, "videoDownloadUrl": "https://get.morelogin.com/pre/cloudPhoneTaskVideo/1542431036481556/4c4fed83685345ae8f1505fbe0c2f123/baby.mp4" } - __Bước 3: Mã hóa chuỗi JSON__ Chuyển đổi đối tượng JSON thành định dạng chuỗi đã được mã hóa: json "{\"__Extra__\": {\"videoDownloadUrl\": {\"name\": \"video_name.mp4\",\"size\": 204800000}},\"videoDownloadUrl\": \"https://get.morelogin.com/pre/cloudPhoneTaskVideo/1542431036481556/4c4fed83685345ae8f1505fbe0c2f123/baby.mp4\"}" - __Bước 4: Gọi API__ Truyền chuỗi đã được mã hóa làm giá trị của tham số templateParameter cho API mục tiêu. ### Hủy lịch trình - [POST /api/cloudphone/rpa/task/cancel](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/schedules/paths/~1api~1cloudphone~1rpa~1task~1cancel/post.md) ### Bản ghi thực thi tác vụ truy vấn trang - [POST /api/cloudphone/rpa/subTask/page](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/schedules/paths/~1api~1cloudphone~1rpa~1subtask~1page/post.md): Mẫu thị trường Lịch trình truy vấn, tên mẫu hỗ trợ truy vấn mờ. ### Thực hiện tác vụ - [POST /api/cloudphone/rpa/subTask/detail/{id}](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/schedules/paths/~1api~1cloudphone~1rpa~1subtask~1detail~1%7Bid%7D/post.md): Mẫu thị trường Lịch trình truy vấn, tên mẫu hỗ trợ truy vấn mờ. ### Hủy bỏ việc thực thi - [POST /api/cloudphone/rpa/subTask/cancel/{id}](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/schedules/paths/~1api~1cloudphone~1rpa~1subtask~1cancel~1%7Bid%7D/post.md) ## Touch ### Chạm - Nhấp - [POST /api/cloudphone/touch/click](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/touch/touchclick.md): Mô phỏng một lần nhấp đơn trên màn hình điện thoại đám mây tại tọa độ được chỉ định. Hệ tọa độ sử dụng góc trên bên trái của màn hình làm gốc (0, 0), trục X mở rộng sang phải và trục Y mở rộng xuống dưới. ### Chạm - Nhấp đúp - [POST /api/cloudphone/touch/doubleClick](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/touch/touchdoubleclick.md): Mô phỏng nhấp đúp trên màn hình điện thoại đám mây tại tọa độ được chỉ định. Hệ tọa độ sử dụng góc trên bên trái của màn hình làm gốc (0, 0), trục X mở rộng sang phải và trục Y mở rộng xuống dưới. ### Chạm - Nhấn giữ - [POST /api/cloudphone/touch/longClick](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/touch/touchlongclick.md): Mô phỏng nhấn giữ trên màn hình điện thoại đám mây tại tọa độ được chỉ định. Sử dụng tham số duration để tùy chỉnh thời gian giữ (tính bằng mili giây). Nếu bỏ qua, thời gian mặc định sẽ được sử dụng. Hệ tọa độ sử dụng góc trên bên trái của màn hình làm gốc (0, 0), trục X mở rộng sang phải và trục Y mở rộng xuống dưới. ### Chạm - Vuốt - [POST /api/cloudphone/touch/swipe](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/touch/touchswipe.md): Mô phỏng vuốt ngón tay từ tọa độ bắt đầu đến tọa độ kết thúc. Sử dụng tham số duration để kiểm soát tốc độ vuốt (tính bằng mili giây). Giá trị lớn hơn dẫn đến vuốt chậm hơn. Hệ tọa độ sử dụng góc trên bên trái của màn hình làm gốc (0, 0), trục X mở rộng sang phải và trục Y mở rộng xuống dưới. ### Chạm - Kéo - [POST /api/cloudphone/touch/drag](https://guide.morelogin.com/vi/api-reference/cloud-phone/local-api/touch/touchdrag.md): Mô phỏng kéo ngón tay từ tọa độ bắt đầu đến tọa độ kết thúc. Tương tự như vuốt, nhưng kéo thường được sử dụng để kéo biểu tượng, phần tử UI, v.v. Sử dụng tham số duration để kiểm soát tốc độ kéo (tính bằng mili giây). Giá trị lớn hơn dẫn đến kéo chậm hơn. Hệ tọa độ sử dụng góc trên bên trái của màn hình làm gốc (0, 0), trục X mở rộng sang phải và trục Y mở rộng xuống dưới.