API

API de ativação por SMS

Compre números e leia códigos de seus próprios scripts. A API usa o formato comum de ativação por SMS, então a maioria dos clientes existentes funciona alterando o endereço base e a chave.

Crie sua chave API na página de chaves API do console. Ela é exibida uma única vez.

Obter chave API Cadastrar

Endereço base e chave

Envie solicitações GET ou POST para o endereço base com api_key e action. Crie a chave na página Chave API do console; ela é exibida uma única vez.

https://snsactivate.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance

Os códigos de serviço são os nomes em nossas páginas de serviço (por exemplo whatsapp, telegram, google). Os códigos de país são códigos ISO em letras minúsculas (us, gb, in). Limite: 300 solicitações por minuto por chave. Cada ativação tem uma janela de 20 minutos, igual ao console.

getBalance

Seu saldo em USD.

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getBalance

ACCESS_BALANCE:12.50

getServicesList

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

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getServicesList

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

getCountries

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

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getCountries

{"us":{"name":"United States","dial":"1"}}

getPrices

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

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getPrices&service=whatsapp&country=us

{"us":{"whatsapp":{"cost":0.18,"count":130598}}}

getNumber

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

GET https://snsactivate.com/stubs/handler_api.php?api_key=KEY&action=getNumber&service=whatsapp&country=us

ACCESS_NUMBER:AC-7K2M9QX4PB:13475550182

getStatus

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

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

STATUS_OK:482913

setStatus

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).

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

ACCESS_RETRY_GET

Fluxo típico

getNumber com o serviço e o país. Salve o ID.
Insira o número no aplicativo e solicite o SMS.
Chame getStatus a cada 5 a 10 segundos até STATUS_OK.
Precisa de outro SMS? setStatus 3, então getStatus novamente. Concluído: setStatus 6.
Nenhum código? setStatus 8 cancela com reembolso total. Sem uma chamada, o reembolso acontece automaticamente quando a janela termina.

Erros

BAD_KEY	Chave 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 pertence a você.
EARLY_CANCEL_DENIED	Um código já chegou, então a ativação não pode ser cancelada.
TOO_MANY_REQUESTS	Mais de 300 solicitações em um minuto.
NO_ACTIVATIONS	20 ativações já estão abertas.