# API de verificação por SMS

Tudo o que o painel faz, por código. Mesmos preços, sem sobretaxa de API, e um endpoint que fala o protocolo SMS-Activate para as ferramentas que já existem.

## Como receber um código de verificação pela API?

Crie uma chave no painel depois da primeira recarga, chame o endpoint que reserva um número para um serviço e um país, use o número no seu fluxo e consulte o pedido até o texto do SMS voltar. Conclua o pedido para liberar o número, ou cancele antes de chegar qualquer SMS para liberar o valor congelado.

## O que a API cobre

- Catálogo: serviços, países, preços e taxa de sucesso ao vivo.
- Pedidos: pegar número, consultar o SMS, pedir outro SMS, cancelar, concluir, reportar número ruim.
- Aluguéis: iniciar, listar mensagens, renovar.
- Conta: saldo (disponível e o que está retido em pedidos abertos). Extrato e troca de chave ficam no painel.
- Status: consulte o pedido e leia o SMS assim que chegar (sem webhook).

## Endpoint compatível com SMS-Activate

Softwares de cadastro e bots feitos para o protocolo SMS-Activate (getNumber, getStatus, setStatus, getBalance, getPrices) funcionam com o SMS Nitro trocando a URL base e a chave. Se a sua ferramenta tem um campo de "provedor SMS-Activate personalizado", aponte para cá.

## SDKs e exemplos

Clientes oficiais para Python e Node, mais uma coleção do Postman com todas as chamadas. Os exemplos cobrem o ciclo inteiro: reservar, esperar o código com timeout, concluir ou cancelar.

## Limites e preços

A compra aceita até 500 pedidos por minuto por conta (e por IP no REST), e o reenvio de SMS até 30 por minuto por IP. Consultar a cada poucos segundos é normal. Os preços são iguais aos do painel. Cada conta tem uma chave ativa: gerar outra revoga a anterior. Volume alto? Fale com o suporte.

## FAQ

**Preciso de um plano especial para a API?** Não. Qualquer conta com recarga pode criar uma chave.

**Meus scripts de SMS-Activate funcionam?** Sim, pelo endpoint compatível: troque a URL e a chave.

**Tem ambiente de testes?** Use uma recarga pequena e serviços baratos para testar; número que não recebe SMS nunca é cobrado.

Source: https://smsnitro.com/pt/api