Saltar para o conteúdo
RemindCash

Limites de pedidos

Quantos pedidos cada chave de API pode fazer e como tratar as respostas 429.

Estado da API pública

A API v1 usa chaves bearer da empresa e exige um período de plano ativo. Os endpoints de rascunhos e de comunicação de pagamentos não enviam mensagens a clientes. Os exemplos usam marcadores — nunca cole uma chave real em código partilhado.

Limites

Cada chave de API pode fazer 60 pedidos por minuto. O limite é contado por chave, por isso chaves diferentes têm orçamentos separados.

O período experimental, Basic ou Pro ativo também tem uma quota total de pedidos de API. Os pedidos que a consomem são contados por empresa e por período. Sem um período ativo, os pedidos a dados protegidos devolvem 403 forbidden; depois de a quota se esgotar, devolvem 429 rate_limited. GET /v1/usage mostra a quota atual sem a consumir. O limite de 60 por minuto por chave continua a aplicar-se.

Quando atinge o limite

A API responde com 429 Too Many Requests, o corpo de erro habitual e um cabeçalho Retry-After com o número de segundos a esperar.

JSON
{
    "error": {
        "code": "rate_limited",
        "message": "Too many requests."
    },
    "request_id": "0c998db5-ab69-49f5-8058-227973e19dbc"
}

Ficar dentro do limite

  • Espere pelo Retry-After antes de repetir e acrescente uma variação aleatória (jitter) se vários processos partilharem uma chave.
  • Use per_page até 100 para ler mais itens por pedido.
  • Dê chaves separadas a sistemas separados, para que uma integração muito ativa não abrande outra.