Referência

Limites de taxa

Cada chave de API pode fazer 600 solicitações em qualquer janela de 60 segundos. Os endpoints de preços são públicos e não são contabilizados para uma chave.

CabeçalhoSignificado
X-RateLimit-LimitSolicitações permitidas por janela (600).
X-RateLimit-RemainingSolicitações restantes na janela atual.
X-RateLimit-ResetSegundos até que a solicitação mais antiga saia da janela.
Retry-AfterSomente no caso de 429: segundos para esperar.

Enviando grandes volumes

Lotes tornam o limite generoso: 600 solicitações de lote com 10.000 números são milhões de mensagens por minuto de solicitações. A fila então entrega as mensagens à rede em até 1.200 por minuto por conta, na ordem em que foram aceitas.

Quando você atinge o limite

429 Too Many RequestsJSON
{
  "error": {
    "code": "rate_limited",
    "message": "This key made more than 600 requests in the last minute. Retry after 12 seconds.",
    "doc_url": "https://bulksmsapi.cc/en/docs/errors#rate_limited"
  }
}
Limites de taxa | Documentação BulkSMSAPI