Limites
Limites de taxa
| O quê | Limite | Vale para |
|---|---|---|
| Solicitações por chave | 120 por minuto | Toda chamada autenticada (/v1/* com chave, ferramentas do MCP). Um parceiro agindo com X-Wyro-External-Id conta na chave desse cliente. |
| Solicitações por IP | 300 por minuto | Chamadas sem chave de workspace: POST /v1/sandbox e a API de parceiros (/v1/partner/*). |
| Chaves de teste | 5 por IP por hora | POST /v1/sandbox (sandbox_limit). |
| Posts reais no período de teste | 25 por dia | Posts em contas reais com uma chave que não está em um plano pago. |
As janelas são deslizantes: o limite conta as chamadas do último minuto (ou hora, ou dia), não um minuto do relógio.
Quando você passa do limite, a resposta é 429 com:
| Header | Significado |
|---|---|
Retry-After |
Segundos para esperar antes de tentar de novo. |
X-RateLimit-Limit |
O limite atingido. |
X-RateLimit-Remaining |
Chamadas que restam na janela (0). |
Os SDKs esperam o Retry-After e tentam de novo sozinhos.
Tamanhos
| O quê | Limite |
|---|---|
| Mídias por post | 10 |
Envio direto para POST /v1/media |
4 MB (arquivos maiores: envio pré-assinado) |
Posts por página em GET /v1/posts |
100 |
| Duração da chave de teste | 72 horas |
Idempotency-Key |
255 caracteres, lembrada por 24 h |
| Tentativa de webhook | 5 s, 8 tentativas |
Os limites de texto por rede estão em Publicar. Status do serviço ao vivo: https://wyroapi.com/pt/status.