Limites de taxa

A API MoreLogin impõe limites de taxa para garantir o uso justo e a estabilidade do sistema.

Limites

Tipo de API	Limite de taxa	Janela
API local	120 solicitações	por minuto
API aberta	120 solicitações	por minuto

Resposta de limite de taxa

Quando você excede o limite de taxa, a API retorna:

Status HTTP: 429 Too Many Requests

{
  "code": 429,
  "msg": "Rate limit exceeded",
  "data": null,
  "requestId": "..."
}

Melhores Práticas

1. Implementar nova tentativa com retirada

import time
import requests

def api_request_with_retry(url, payload, max_retries=3):
    for attempt in range(max_retries):
        response = requests.post(url, json=payload)
        if response.status_code == 429:
            wait_time = 2 ** attempt  # 1s, 2s, 4s
            print(f"Rate limited. Retrying in {wait_time}s...")
            time.sleep(wait_time)
            continue
        return response
    raise Exception("Max retries exceeded")

2. Operações em lote

Em vez de fazer chamadas de API individuais, use endpoints em lote quando disponíveis:

# Bad: 100 individual calls
for env_id in env_ids:
    requests.post(f"{BASE}/api/env/start", json={"envId": env_id})

# Good: Use batch endpoints
requests.post(f"{BASE}/api/env/updateGroup/batch", json={
    "envIds": env_ids,
    "groupId": "target-group"
})

3. Respostas de cache

Para dados que não mudam com frequência (por exemplo, listas de fuso horário, listas de plataformas), armazene a resposta em cache localmente:

# Cache timezone/language data — it rarely changes
timezone_data = requests.post(f"{BASE}/api/env/advanced/timezone").json()
# Reuse timezone_data for subsequent profile creations

Monitorando seu uso

Acompanhe a frequência de chamadas da API. Se você se aproximar consistentemente do limite, considere:

Distribuindo solicitações uniformemente ao longo do minuto
Usando webhooks (em breve) em vez de pesquisas
Combinando múltiplas operações em chamadas em lote