> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sondercloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate Limiting

> Entenda como funciona o rate limiting na API SonderCloud

## 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:

```json 429 Too Many Requests theme={null}
{
  "statusCode": 429,
  "message": "ThrottlerException: Too Many Requests",
  "error": "Too Many Requests"
}
```

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

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

## Boas Práticas

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

> [!TIP]
>
> **Agrupe operações**: use os endpoints de listagem (`GET /v1/apps`, `GET /v1/databases`) em vez de várias requisições individuais.

## Próximos Passos

> **[Apps](https://docs.sondercloud.app/api-reference/endpoint/apps/list.md)**
>
> Comece a criar e gerenciar seus apps.

> **[Databases](https://docs.sondercloud.app/api-reference/endpoint/databases/create.md)**
>
> Aprenda a provisionar e gerenciar databases.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.