# Chave de API, limites e erros

Tudo o que quem programa precisa no primeiro dia com a API, em uma página.

## Como consigo uma chave de API do SMS Nitro?

Faça uma recarga, abra a seção API do painel e crie uma chave. As chaves podem ser trocadas a qualquer momento; a antiga para de funcionar na hora. Use como token Bearer na API REST ou como parâmetro api_key no endpoint compatível com SMS-Activate.

## Limites

- Compra: até 500 compras por minuto por conta, somando REST e handler_api; no REST vale também o teto de 500 por minuto por IP.
- Reenvio de SMS: até 30 requisições por minuto por IP. Consultar um pedido a cada poucos segundos é normal.
- Cada conta tem uma chave ativa; gerar outra no painel revoga a anterior.

## Respostas comuns

- NO_NUMBERS: nenhum número retornado para esse par serviço × país nessa chamada; tente de novo ou outro país.
- NO_BALANCE: recarregue; o valor congelado dos números ativos conta contra o saldo.
- BAD_KEY: a chave foi trocada ou está malformada.
- STATUS_WAIT_CODE / STATUS_OK: esperando o SMS / SMS entregue (endpoint compatível).

## FAQ

**Tem webhook?** Para SMS, não. Consulte o status do pedido (a cada poucos segundos, dentro do limite de requisições) e leia o texto do SMS assim que chegar.

Source: https://smsnitro.com/pt/ajuda/chave-de-api-e-limites