Limites de requisições e códigos de resposta da API do Multilogin
No Multilogin, os limites da API indicam quantas solicitações você pode enviar por minuto, enquanto os códigos de resposta mostram se a solicitação foi concluída com sucesso ou o que deu errado.
➡️ No Postman, abra a collection “Multilogin API” → escolha uma request → clique em “Send” → confira o status e o corpo da resposta.
Se você usa a API regularmente para automação, use um token de automação. Ele tem uma validade maior e permite mais solicitações por minuto do que um token comum da API, que expira após 30 minutos.
Quem pode usar a automação?
- 👨💻 Responsável pela conta e todos os membros da equipe (o acesso aos recursos depende da função)
- 💰 Disponível no Pro 10 e planos superiores
Qual é a diferença entre os tipos de token da API?
O Multilogin usa três tipos de token para diferentes tarefas de autenticação.
- Token de automação: gere usando “Workspace Automation Token” — recomendado para automações recorrentes, com período de validade personalizado e os limites de RPM do seu plano
- Token comum da API: copie em “Info” → “API token” no Multilogin ou obtenha por meio de “User Sign In” — expira após 30 minutos e tem limites de requisições menores
- Refresh token: é retornado por “User Sign In” — use com “User Refresh Token (Switch Workspace)” para obter um novo token comum da API sem precisar fazer login novamente
O refresh token serve apenas para obter um novo token comum da API. Você não pode usá-lo para enviar solicitações da API nem para renovar um token de automação.
Se o token de automação expirar, use um token comum da API válido para gerar um novo.
Quantas solicitações da API posso enviar?
O Multilogin mede os limites da API em RPM (solicitações por minuto). Cada solicitação da API conta para esse limite, independentemente de você estar gerenciando telefones Android em nuvem, perfis de navegador ou outros recursos do Multilogin.
Os limites para tokens de automação são:
- Pro 10: 50 RPM
- Pro 20: 75 RPM
- Pro 50: 100 RPM
- Business: 100 RPM nos planos padrão — planos Business superiores podem ter limites personalizados
Você pode conferir os limites atuais na página de preços do Multilogin.
Os membros da equipe compartilham o mesmo limite da API?
Sim. Todos no mesmo espaço de trabalho compartilham o mesmo limite de RPM, mesmo que usem scripts de automação ou tokens diferentes.
Por exemplo, no Pro 20, o espaço de trabalho pode enviar até 75 solicitações por minuto. Se dois membros da equipe enviarem 40 solicitações cada no mesmo minuto, o limite poderá ser ultrapassado.
O que acontece quando atinjo o limite da API?
O Multilogin retorna 429 – Too Many Requests quando você ultrapassa o limite de RPM.
Aguarde até o limite ser redefinido antes de enviar mais solicitações. Se isso acontecer com frequência, tente distribuir as solicitações ao longo do tempo em vez de enviar todas de uma vez.
Precisa enviar mais solicitações por minuto? Confira os planos disponíveis ou entre em contato com o suporte do Multilogin para conhecer suas opções.
O que significam os códigos de resposta da API?
Cada solicitação da API do Multilogin retorna um código de status HTTP. Ele informa se a solicitação foi concluída com sucesso ou se há algum problema que precisa ser corrigido.
Os códigos mais comuns são:
-
200 – OK: a solicitação foi concluída com sucesso -
201 – Created: o recurso foi criado com sucesso -
400 – Bad Request: falta alguma informação ou há algo incorreto na solicitação — verifique os parâmetros e valores obrigatórios -
401 – Unauthorized: o token pode estar ausente, incorreto ou expirado — verifique “Authorization” → “Bearer Token” -
403 – Forbidden: você não tem permissão para realizar a ação — verifique sua função no espaço de trabalho -
404 – Not Found: o recurso solicitado não foi encontrado — verifique o endpoint documentado e os IDs usados na solicitação -
429 – Too Many Requests: você atingiu o limite de requisições da API — aguarde até o limite ser redefinido -
500 – Internal Server Error: ocorreu um problema no servidor — tente novamente mais tarde ou entre em contato com o suporte se o problema continuar
Você pode comparar sua solicitação com os parâmetros e formatos obrigatórios na documentação da API do Multilogin.
Está recebendo um erro?
Confira também o corpo da resposta. Ele geralmente contém uma mensagem mais específica que pode ajudar a identificar o problema.
O que significa download_browser_profile_metadata com 200?
Significa que o Multilogin conseguiu obter os dados do perfil de navegador no servidor para uso posterior.
Isso é normal e não é um erro. Você não precisa fazer nada.