API de Ativação por SMS

O formato comum de ativação em texto simples, para ferramentas que já o utilizam. Novas integrações também podem usar a API REST.

Introdução aos Números de Verificação

Cada chamada é uma requisição GET (ou POST) para https://snsverify.com/stubs/handler_api.php com sua chave de API e um parâmetro de ação. A chave vem da página de chave de API do seu console; mantenha-a privada, pois pode gastar seu saldo. As respostas são linhas de texto curtas como ACCESS_NUMBER ou STATUS_OK, ou JSON para as ações de lista, exatamente como outros serviços que usam este formato.

Mesma conta, mesmas regras. Números comprados aqui usam os mesmos preços, a mesma janela de 20 minutos e o mesmo reembolso automático do site. Os códigos de serviço são os nomes em letras minúsculas que você vê em nosso site (whatsapp, telegram, google); os códigos de país são ISO: us, gb, nl, de, af, al, dz, ao, ai, ar, am, aw, au, at, az, bs, bh, bd, bb, by, be, bz, bj, bt, bo, ba, bw, br, bn, bg, bi, kh, cm, ca, td, cl, cn, co, km, hr, cy, cz, dk, dj, dm, ec, eg, er, ee, sz, et, fj, fi, fr, ga, gm, ge, gh, gi, gr, gd, gp, gt, gn, gy, ht, hn, hk, hu, is, in, id, iq, ie, il, it, jm, jp, jo, kz, ke, kw, kg, la, lv, lb, ls, lr, lt, lu, mo, mg, mw, my, mv, ml, mt, mr, mu, mx, md, mc, mn, me, ms, ma, mz, na, np, nz, ni, ne, ng, no, om, pk, pa, py, pe, ph, pl, pt, qa, ro, rw, sn, rs, sc, sg, sk, si, so, za, es, sr, se, ch, tw, tj, tz, th, tg, tn, tr, tm, ug, ua, uy, uz, ve, vn, ye, zm, zw.

getBalance (GET) [+]

Seu saldo em USD.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getBalance

Resposta

ACCESS_BALANCE:12.50

getServicesList (GET) [+]

Códigos de serviço que você pode comprar (JSON).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getServicesList

Resposta

{"status":"success","services":[{"code":"whatsapp","name":"WhatsApp"}]}

getCountries (GET) [+]

Códigos de país (ISO, minúsculas) e códigos de discagem (JSON).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getCountries

Resposta

{"gb":{"name":"United Kingdom","dial":"44"}}

getPrices (GET) [+]

Preços em USD por país e serviço. Ambos os filtros são opcionais.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getPrices&service=whatsapp&country=gb

Resposta

{"gb":{"whatsapp":{"cost":0.94,"count":100}}}

getNumber (GET) [+]

Compra um número. Retorna o id de ativação e o número com seu código de país.

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getNumber&service=whatsapp&country=gb

Resposta

ACCESS_NUMBER:AC-7K2M9QX4PB:447700900123

getStatus (GET) [+]

STATUS_WAIT_CODE (nenhum código ainda), STATUS_OK:<code>, STATUS_WAIT_RETRY:<último código> (outro código solicitado), STATUS_CANCEL (cancelado ou reembolsado).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=getStatus&id=AC-7K2M9QX4PB

Resposta

STATUS_OK:482915

setStatus (GET) [+]

status=1 pronto (ACCESS_READY), 3 outro código (ACCESS_RETRY_GET), 6 finalizar (ACCESS_ACTIVATION), 8 cancelar com reembolso total enquanto nenhum código chegou (ACCESS_CANCEL).

https://snsverify.com/stubs/handler_api.php?api_key=$KEY&action=setStatus&id=AC-7K2M9QX4PB&status=3

Resposta

ACCESS_RETRY_GET

Fluxo Típico

Chame getNumber com serviço e país. Salve o id de ativação e forneça o número ao aplicativo.
Chame setStatus com status=1 quando o aplicativo enviou o SMS (opcional, apenas marca a ativação como pronta).
Consulte getStatus a cada 3 a 5 segundos até que responda STATUS_OK com o código.
Precisa de outro código? setStatus status=3, então consulte novamente até STATUS_OK mostrar o novo código.
Concluído: setStatus status=6. Sem código e quer seu dinheiro de volta agora: setStatus status=8 (apenas antes de um código chegar). Caso contrário, a ativação se reembolsa após 20 minutos.

Respostas de Erro

BAD_KEY	Chave de API ausente ou incorreta.
BAD_ACTION	Ação desconhecida.
BAD_SERVICE	Código de serviço desconhecido.
BAD_COUNTRY	O serviço não é vendido nesse país.
NO_BALANCE	Saldo insuficiente.
NO_NUMBERS	Nenhum número disponível no momento. Tente novamente em breve.
NO_ACTIVATION	Id de ativação desconhecido ou não é seu.
EARLY_CANCEL_DENIED	Um código já chegou, então a ativação não pode ser cancelada.
TOO_MANY_REQUESTS	Mais de 300 requisições em um minuto.
NO_ACTIVATIONS	20 ativações já estão abertas.

Limites: 300 requisições por minuto por chave, até 20 ativações abertas por conta. Preços em 2026-11-04