Rate Limiting

Visão Geral

A API SonderCloud implementa rate limiting para garantir estabilidade, segurança e uso justo dos recursos.

Limite Geral

Todas as rotas /v1 compartilham o seguinte limite:

Métrica	Valor
Limite	30 requisições por minuto
Janela	60 segundos

Limite de Upload

O endpoint de criação de app (POST /v1/apps/upload) tem um limite adicional, específico por usuário:

Métrica	Valor
Limite	50 uploads
Janela	10 minutos

Resposta 429 (Too Many Requests)

Quando o limite geral é excedido, você recebe uma resposta HTTP 429 no formato padrão de erro da API:

429 Too Many Requests

{
  "statusCode": 429,
  "message": "ThrottlerException: Too Many Requests",
  "error": "Too Many Requests"
}

Quando o limite de upload é excedido, a mensagem indica o tempo de espera:

429 Too Many Requests

{
  "statusCode": 429,
  "message": "Limite de upload excedido (50 por 10 minutos). Aguarde 10 minutos e tente novamente.",
  "error": "Too Many Requests"
}

Boas Práticas

Implemente retry com backoff: não faça requisições imediatamente após receber 429. Aguarde alguns segundos antes de tentar novamente.

Agrupe operações: use os endpoints de listagem (GET /v1/apps, GET /v1/databases) em vez de várias requisições individuais.

Fundamentos

Aplicações

Databases

Conta

Visão Geral

Limite Geral

Limite de Upload

Resposta 429 (Too Many Requests)

Boas Práticas

Próximos Passos

Apps

Databases

​Visão Geral

​Limite Geral

​Limite de Upload

​Resposta 429 (Too Many Requests)

​Boas Práticas

​Próximos Passos

Apps

Databases

Visão Geral

Limite Geral

Limite de Upload

Resposta 429 (Too Many Requests)

Boas Práticas

Próximos Passos