Limites
Proteções técnicas por minuto e franquias mensais do plano. Todas são do tenant e compartilhadas entre API Keymatic, MCP e o produto.
Por minuto
| Limite | Valor | Código no 429 |
|---|---|---|
| Por IP | 300 req/min | limite_tecnico |
| Por chave | limite_por_minuto da chave, de 1 a 60 (padrão 60) | limite_credencial |
| Por tenant | 60 novas operações/min, inclusive no plano founder | limite_tecnico |
| Chave de projeto | 60 req/min por chave e 300/min por IP | limite_credencial ou limite_tecnico |
Todo 429 traz Retry-After em segundos. Espere esse tempo antes de repetir; com Idempotency-Key, a repetição não duplica a escrita.
const resposta = await fetch("https://ig.keymatic.com.br/api/instagram/perfil", {
headers: { Authorization: `Bearer ${process.env.KEYMATIC_API_KEY}` },
});
if (resposta.status === 429) {
const segundos = Number(resposta.headers.get("Retry-After") ?? 60);
const { erro } = await resposta.json();
// franquia_esgotada e publicacoes_esgotadas não passam com espera curta
agendarNovaTentativa(segundos, erro.codigo);
}Franquias do plano
Cada plano define, por mês civil em America/Sao_Paulo, quantas operações, publicações e respostas o tenant pode fazer. Os valores vigentes vêm do catálogo e aparecem em GET /uso e em Uso; null significa ilimitado.
- Leituras de dados e novas escritas aceitas reservam uma operação.
GET /uso,GET /operacoes/{id}e cancelamento não reservam.- Repetição idempotente não cria outra reserva. Erro de validação ou franquia antes da reserva não conta.
- Publicação reserva o mês agendado e o mês do envio, para proteger a virada de mês.
Esgotado o mês, o 429 vem com franquia_esgotada ou publicacoes_esgotadas. Esperar alguns segundos não resolve: amplie o plano ou aguarde o próximo período.
Limites da Meta
A assinatura não remove regras da Meta. Respostas no Direct só valem para mensagem recebida dentro de 24 h, sem opt-out, e não iniciam conversa. Publicação aceita legenda de até 2.200 caracteres e carrossel de 2 a 10 imagens; a Meta valida codecs e duração de vídeo.