Trong Multilogin, giới hạn tần suất API cho biết bạn có thể gửi bao nhiêu yêu cầu mỗi phút, còn mã phản hồi cho biết yêu cầu có thành công hay không hoặc đã xảy ra lỗi gì.

➡️ Trong Postman, mở collection “Multilogin API” → chọn một request → nhấp “Send” → kiểm tra trạng thái và nội dung phản hồi.

Nếu thường xuyên dùng API để tự động hóa, hãy sử dụng token tự động hóa. Token này có thời hạn dài hơn và cho phép gửi nhiều yêu cầu mỗi phút hơn API token thông thường, vốn hết hạn sau 30 phút.

Các loại API token khác nhau như thế nào?

Multilogin sử dụng ba loại token cho các mục đích xác thực khác nhau.

• Token tự động hóa: tạo bằng “Workspace Automation Token” — phù hợp cho các tác vụ tự động hóa thường xuyên, cho phép tùy chỉnh thời hạn và áp dụng giới hạn RPM theo gói của bạn
• API token thông thường: sao chép từ “Info” → “API token” trong Multilogin hoặc lấy qua “User Sign In” — hết hạn sau 30 phút và có giới hạn tần suất thấp hơn
• Refresh token: được trả về bởi “User Sign In” — dùng với “User Refresh Token (Switch Workspace)” để lấy API token thông thường mới mà không cần đăng nhập lại

Refresh token chỉ dùng để lấy API token thông thường mới. Bạn không thể dùng refresh token để gửi yêu cầu API hoặc gia hạn token tự động hóa.

Nếu token tự động hóa hết hạn, hãy dùng một API token thông thường còn hiệu lực để tạo token mới.

Tôi có thể gửi bao nhiêu yêu cầu API?

Multilogin tính giới hạn API theo RPM (số yêu cầu mỗi phút). Mỗi yêu cầu API đều được tính vào giới hạn này, dù bạn đang quản lý điện thoại Android đám mây, hồ sơ trình duyệt hay các tài nguyên Multilogin khác.

Giới hạn dành cho token tự động hóa:

• Pro 10: 50 RPM
• Pro 20: 75 RPM
• Pro 50: 100 RPM
• Business: 100 RPM đối với các gói tiêu chuẩn — các gói Business cao hơn có thể có giới hạn riêng

Bạn có thể kiểm tra giới hạn hiện tại trên trang giá của Multilogin.

Các thành viên trong nhóm có dùng chung giới hạn API không?

Có. Tất cả thành viên trong cùng một không gian làm việc dùng chung một giới hạn RPM, ngay cả khi họ sử dụng các script tự động hóa hoặc token khác nhau.

Ví dụ, nếu bạn đang dùng Pro 20, không gian làm việc có thể gửi tối đa 75 yêu cầu mỗi phút. Nếu hai thành viên cùng gửi 40 yêu cầu trong một phút, tổng số yêu cầu có thể vượt quá giới hạn.

Điều gì xảy ra khi tôi đạt giới hạn API?

Multilogin trả về 429 – Too Many Requests khi bạn vượt quá giới hạn RPM.

Hãy chờ giới hạn được đặt lại trước khi gửi thêm yêu cầu. Nếu thường xuyên gặp tình trạng này, hãy thử giãn khoảng thời gian giữa các yêu cầu thay vì gửi tất cả cùng lúc.

Cần gửi nhiều yêu cầu hơn mỗi phút? Hãy xem các gói hiện có hoặc liên hệ với bộ phận hỗ trợ của Multilogin để tìm phương án phù hợp.

Mã phản hồi API có ý nghĩa gì?

Mỗi yêu cầu Multilogin API đều trả về một mã trạng thái HTTP. Mã này cho biết yêu cầu có thành công hay không hoặc có vấn đề nào cần xử lý.

Các mã thường gặp:

• 200 – OK: yêu cầu đã được xử lý thành công
• 201 – Created: tài nguyên đã được tạo thành công
• 400 – Bad Request: yêu cầu bị thiếu hoặc có thông tin không chính xác — kiểm tra các tham số và giá trị bắt buộc
• 401 – Unauthorized: token có thể bị thiếu, không chính xác hoặc đã hết hạn — kiểm tra “Authorization” → “Bearer Token”
• 403 – Forbidden: bạn không có quyền thực hiện thao tác này — kiểm tra vai trò trong không gian làm việc
• 404 – Not Found: không tìm thấy tài nguyên được yêu cầu — kiểm tra endpoint trong tài liệu và các ID trong yêu cầu
• 429 – Too Many Requests: bạn đã đạt giới hạn tần suất API — chờ giới hạn được đặt lại
• 500 – Internal Server Error: đã xảy ra lỗi phía máy chủ — thử lại sau hoặc liên hệ hỗ trợ nếu lỗi vẫn tiếp diễn

Bạn có thể đối chiếu yêu cầu của mình với các tham số và định dạng cần thiết trong tài liệu Multilogin API.

download_browser_profile_metadata trả về 200 có nghĩa là gì?

Điều này có nghĩa là Multilogin đã lấy thành công dữ liệu hồ sơ trình duyệt từ máy chủ để sử dụng sau đó.

Đây là trạng thái bình thường, không phải lỗi. Bạn không cần làm gì thêm.