Escolha um idioma

API para desenvolvedores

Compre números pelo seu próprio software com chaves de API, descontos de atacado, webhooks assinados e um endpoint compatível com sms-activate.

5 guias · 4 respostas rápidas

Guias

  • Início rápido da API para desenvolvedores Compre números e leia códigos pelo seu próprio software. Crie uma chave, consulte preços, compre um número, espere o SMS e finalize, passo a passo. 4 min de leitura
  • Chaves de API e segurança Escopos, listas de IPs permitidos, limites diários de gasto, expiração, rotação sem interrupção e o que fazer se uma chave vazar. 3 min de leitura
  • Preços de atacado e faixas de volume A API vende pelos mesmos preços do app, menos o seu desconto de atacado: uma faixa de volume pelos gastos de 30 dias ou um desconto fixo de revendedor. 3 min de leitura
  • Webhooks Receba eventos de ativação no seu servidor em tempo real, verifique o cabeçalho SmsGrab-Signature e entenda novas tentativas, entregas de teste e desativação automática. 4 min de leitura
  • O endpoint compatível com sms-activate Continue usando bots e painéis feitos para o protocolo sms-activate mudando uma URL. Ações compatíveis, formatos de ids e as diferenças que você precisa conhecer. 2 min de leitura

Respostas rápidas

Quanto custa a API para desenvolvedores?

Não há assinatura: você paga por número, com seu saldo normal. Cada número custa o mesmo que no app, menos o seu desconto de atacado. As faixas de volume reduzem o preço assim que seus gastos líquidos dos últimos 30 dias, em todos os canais, passam de um limite, e revendedores aprovados têm um desconto fixo; vale sempre o maior dos dois. Números sem código são reembolsados como sempre. Veja Preços de atacado e faixas de volume.

Abrir esta resposta em uma página própria
Quantas requisições posso enviar à API?

Por padrão, cada chave pode enviar 600 requisições e fazer 60 compras por minuto, e todas as chaves de uma conta juntas 3.000 requisições por minuto. Até 100 números podem esperar um código ao mesmo tempo por conta, e até 20 requisições em espera (?wait=) podem ficar abertas por chave. Acima de um limite você recebe 429 RATE_LIMITED com o cabeçalho Retry-After; toda resposta também traz cabeçalhos RateLimit-*. Veja Início rápido da API para desenvolvedores.

Abrir esta resposta em uma página própria
Minha chave de API vazou. O que eu faço?

Aja na hora: revogue a chave em Conta > Desenvolvedores, ou rotacione com um período de transição de 0 hora. Revogar é imediato e não pede senha. Depois confira o registro de requisições da chave e sua Carteira em busca de atividades que você não reconhece, e crie uma chave nova com lista de IPs permitidos e limite diário de gasto. Guarde chaves apenas em servidores, nunca em apps ou páginas web. Veja Chaves de API e segurança.

Abrir esta resposta em uma página própria
Ferramentas feitas para sms-activate funcionam com o SmsGrab?

Sim, na maioria dos casos. Aponte a ferramenta para https://smsgrab.com/api/stubs/handler_api.php e use sua chave de API do SmsGrab como api_key. As ações padrão são compatíveis, de getBalance e getNumber a setStatus e getStatus. Os valores são em dólares americanos no seu preço com o desconto de atacado, não em rublos, e os aluguéis não estão disponíveis. Veja O endpoint compatível com sms-activate.

Abrir esta resposta em uma página própria

Outros temas

Ainda precisa de ajuda?

Escreva para nós. Respondemos a todas as mensagens, geralmente em poucas horas.

Ou envie um e-mail para support@smsgrab.com