Tài liệu API của Multilogin giúp bạn tìm các yêu cầu để quản lý điện thoại Android đám mây, hồ sơ trình duyệt và các tài nguyên Multilogin khác. Bạn có thể xem từng yêu cầu dùng để làm gì, cần những thông tin nào và phản hồi dự kiến ra sao.

➡️ Mở tài liệu API của Multilogin → chọn một thư mục trong thanh bên trái → chọn một yêu cầu → kiểm tra các tham số và ví dụ.

Bạn có thể xem tài liệu mà không cần cài đặt gì. Khi muốn thử một yêu cầu, bạn có thể mở collection trong Postman.

Trước khi bạn bắt đầu

Install Postman VI

Bạn sẽ cần Postman với bộ Multilogin API được nhập khẩu:

1. Cài đặt Postman
2. Mở Multilogin API tài liệu và nhấp vào “Run in Postman”
3. Nhấp vào “Import”

Tôi có thể tìm yêu cầu API cần dùng ở đâu?

Thanh bên trái nhóm các yêu cầu API vào từng thư mục dựa trên tác vụ bạn muốn thực hiện. Tìm tác vụ cần dùng, sau đó mở yêu cầu tương ứng.

Một số thư mục chính gồm:

• “Mobile Profile Management”: tạo, cập nhật, khởi động, dừng và quản lý điện thoại Android đám mây
• “Launcher”: khởi động và dừng hồ sơ trình duyệt, bao gồm hồ sơ nhanh
• “Profile Management”: tạo, cập nhật, xóa và sắp xếp hồ sơ trình duyệt
• “Profile Access Management”: quản lý đăng nhập API, token và thông tin không gian làm việc
• “Proxy”: quản lý proxy và kiểm tra thông tin liên quan đến proxy
• “Script Runner”: chạy các script tự động hóa được hỗ trợ
• “Object Storage”: tải tệp lên và tải tệp xuống
• “2FA”: quản lý xác thực hai yếu tố qua API

Ví dụ, nếu cần danh sách điện thoại Android đám mây, hãy mở “Mobile Profile Management” → “Mobile Profile List”.

Bạn không cần nhớ URL của endpoint. Chỉ cần tìm thao tác bạn muốn thực hiện.

Mỗi phần của yêu cầu API có ý nghĩa gì?

Một yêu cầu API cho Multilogin biết cần thực hiện thao tác gì, chẳng hạn như lấy danh sách điện thoại đám mây hoặc cập nhật hồ sơ trình duyệt. Phản hồi cho biết kết quả của thao tác đó.

Khi mở một yêu cầu trong tài liệu, bạn sẽ thấy:

1. Phương thức HTTP: phương thức cần dùng cho yêu cầu, chẳng hạn như GET, POST, PUT hoặc DELETE
2. Endpoint: URL mà yêu cầu được gửi đến
3. Tham số: các giá trị như profile ID, bộ lọc hoặc số trang – một số là bắt buộc, số khác là tùy chọn
4. Header: thông tin bổ sung của yêu cầu, chẳng hạn như token xác thực
5. Nội dung yêu cầu: dữ liệu bạn gửi đến API, chẳng hạn như cài đặt hồ sơ
6. Phản hồi: kết quả Multilogin trả về, bao gồm mã trạng thái và dữ liệu phản hồi

Bạn cũng sẽ thấy JSON trong nhiều yêu cầu và phản hồi. Đây đơn giản là một định dạng văn bản dùng để sắp xếp thông tin thành các trường và giá trị.

Tôi có thể tìm ví dụ về yêu cầu và phản hồi ở đâu?

Các ví dụ cho bạn biết cần gửi gì và kết quả dự kiến là gì. Bạn có thể tìm thấy chúng trong cả tài liệu API trực tuyến và ứng dụng Postman, nhưng ở những vị trí khác nhau.

Trong tài liệu API trực tuyến:

• “Example Request”: hiển thị mã và thông tin cần thiết để gửi yêu cầu
• “Example Response”: hiển thị phản hồi mà API có thể trả về

Trong ứng dụng Postman:

• Chi tiết yêu cầu: kiểm tra “Params”, “Authorization”, “Headers” và “Body” để tìm thông tin cần thiết
• Ví dụ đã lưu: mở rộng một yêu cầu trong thanh bên để tìm các ví dụ như “Profiles Found”
• Phản hồi thực tế: nhấp “Send” để xem kết quả và mã trạng thái bên dưới yêu cầu

Cần mã cho script? Dùng “Code” trong thanh bên phải của Postman. Xem cách tạo client code.

Để hiểu thêm về lỗi và giới hạn yêu cầu, xem giới hạn tốc độ và mã phản hồi API của Multilogin.

Tôi có thể thay đổi cách hiển thị tài liệu không?

Có! Thanh phía trên cho phép bạn điều chỉnh bố cục và ví dụ mã để sử dụng tài liệu dễ dàng hơn.

Bố cục

Chọn bố cục bạn thấy dễ đọc hơn:

• “Single Column”: hiển thị chi tiết yêu cầu và ví dụ lần lượt từ trên xuống dưới
• “Double Column”: hiển thị chi tiết yêu cầu và ví dụ cạnh nhau

“Double Column” đặc biệt hữu ích khi bạn muốn so sánh các tham số của yêu cầu với một ví dụ mà không phải cuộn lên xuống liên tục.

Language

Menu “Language” cho phép bạn chọn ngôn ngữ lập trình hoặc định dạng dùng cho các ví dụ yêu cầu được tạo tự động, chẳng hạn như cURL.

Ví dụ, nếu đang chuẩn bị một yêu cầu cho script, bạn có thể chuyển sang định dạng được hỗ trợ và dùng mã được tạo làm điểm bắt đầu.

Thao tác này không thay đổi ngôn ngữ của tài liệu.

Bạn cũng có thể điều chỉnh các cài đặt tạo mã dành riêng cho từng ngôn ngữ khi có các tùy chọn đó.

Câu hỏi thường gặp

Không tìm thấy yêu cầu API?

Kiểm tra các thư mục trong thanh bên trái và đảm bảo bạn đang tìm đúng nhóm.

Ví dụ, các yêu cầu dành cho điện thoại đám mây nằm trong “Mobile Profile Management”, còn các yêu cầu dành cho hồ sơ trình duyệt nằm trong “Profile Management” hoặc “Launcher”.

Một số yêu cầu cũ cũng có thể đã được đổi tên hoặc thay thế. Kiểm tra phần mô tả để xem thông tin về phiên bản.

Collection đã import khác với tài liệu?

Collection trong Postman của bạn có thể cũ hơn phiên bản tài liệu đã được xuất bản.

Hãy import phiên bản mới nhất của collection “Multilogin API” và so sánh với bản hiện tại. Nếu bạn đã tùy chỉnh collection, hãy tạo bản sao hoặc export trước khi xóa hay thay thế bất kỳ nội dung nào.