API de verificação por SMS

A API da SNSSIM processa compra de números, verificação de código, cancelamento, consulta de crédito e preços em uma única solicitação HTTP. Usa o padrão do setor, handler_api, então basta alterar o endereço e a chave API nos programas existentes para se conectar imediatamente.

GET /stubs/handler_api.php
  ?api_key=API_KEY&action=getNumber
  &service=telegram&country=gb

ACCESS_NUMBER:SS8Q2K7:447700900123

GET ...&action=getStatus&id=SS8Q2K7
STATUS_OK:48215
Padrão do setor
handler_api

Padrão do setor

Por chave API
300 vezes por minuto

Por chave API

País / Serviço
145 / 1,255

País / Serviço

Reembolso automático se não houver código
20 minutos

Reembolso automático se não houver código

Como obtenho uma chave API?

Gere a chave na seção API após login. Ela é exibida apenas uma vez - salve-a. A API usa o mesmo saldo e preços da interface web.

Qual é o endereço base?

Todas as requisições são enviadas via GET para o mesmo endereço, adicionando api_key e action.

https://snssim.com/stubs/handler_api.php?api_key=API_KEY&action=...

Que tipos de solicitações posso enviar?

São possíveis 7 tipos de requisições, desde a compra de números até a verificação de códigos, cancelamento e consulta de crédito.

actionO que fazExemplo de resposta
getBalanceConsultar saldoACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbPreços e números disponíveis por serviço e país{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbCompra de númeroACCESS_NUMBER:ID:PHONE
getStatus&id=IDVer códigoSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Cancelar uso do número (reembolso total se o código não for recebido)ACCESS_CANCEL
setStatus&id=ID&status=3Receber outro código de verificação no mesmo númeroACCESS_RETRY_GET
setStatus&id=ID&status=6Finalizar usoACCESS_ACTIVATION

Parâmetro

NomeObrigatórioDescrição
api_keyTodosChave de API criada na tela da conta
actionTodosgetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberCódigo do nome do serviço (exemplo: telegram, whatsapp, google). É o mesmo valor da página de lista de serviços
countrygetNumberCódigo de país de 2 letras (ex: br, us, id)
idgetStatus, setStatusID do número emitido pelo getNumber (começa com N)
statussetStatus8 para cancelar, 3 para solicitar código novamente, 6 para sair, 1 para pronto

Texto da resposta e significado

As respostas são fornecidas em texto conciso. O status da dedução de créditos também é exibido.

RespostaSignificadoDinheiro
ACCESS_NUMBER:ID:PHONENúmero recebidoO valor do número é cobrado
STATUS_WAIT_CODEAguardando o códigoMantido
STATUS_OK:CODEO código chegouPagamento concluído
STATUS_WAIT_RETRY:CODEAguardando código de verificação adicional (incluindo o código anterior)Sem custo extra
STATUS_CANCELCancelado ou tempo esgotadoReembolsado se não houve código
ACCESS_CANCELCanceladoReembolso total
ACCESS_RETRY_GETAguardando recebimento de outro código no mesmo númeroSem custo extra
ACCESS_ACTIVATIONUso do número finalizadoMantido
NO_BALANCERecarregue o saldo e receba na horaNão é cobrado
NO_NUMBERSAtualmente, não podemos fornecer números para este país.Não é cobrado
NO_ACTIVATIONSVocê tem 20 números abertosNão é cobrado
EARLY_CANCEL_DENIEDPara números que receberam o código de verificação, selecione Finalizar (6) em vez de CancelarMantido
BAD_KEYChave de API inválidaNão é cobrado
BAD_SERVICE / BAD_COUNTRYO código do serviço ou do país está incorretoNão é cobrado
NO_ACTIVATIONID do número não encontradoMantido
TOO_MANY_REQUESTSLimite de 300 por minuto excedidoNão é cobrado

Qual é a sequência para receber códigos via API?

São 4 etapas: receber o número, inseri-lo, verificar o código e finalizar.

  1. 1 etapas

    Obter número

    Use getNumber para escolher o serviço e país desejados e obter um número.

    action=getNumber&service=telegram&country=gb
    > ACCESS_NUMBER:SS8Q2K7:447700900123
  2. 2 etapas

    Inserir número

    Insira o número comprado na página de cadastro ou aplicativo.

    +44 7700 900123
  3. 3 etapas

    Ver código

    Chame getStatus a cada 5 segundos para verificar se o código chegou.

    action=getStatus&id=SS8Q2K7
    > STATUS_OK:48215
  4. 4 etapas

    Finalizar

    Após inserir o código, finalize com setStatus 6. Códigos não recebidos em 20 minutos são reembolsados automaticamente.

    action=setStatus&id=SS8Q2K7&status=6
    > ACCESS_ACTIVATION

Exemplos por linguagem

Este é o processo completo de receber o número, aguardar o código e finalizar. Clique na aba para mudar o idioma.

import time, requests

BASE = "https://snssim.com/stubs/handler_api.php"
KEY = "API_KEY"

def call(**p):
    return requests.get(BASE, params={"api_key": KEY, **p}, timeout=30).text

r = call(action="getNumber", service="telegram", country="gb")
if not r.startswith("ACCESS_NUMBER"):
    raise SystemExit(r)
_, num_id, phone = r.split(":")
print("Number:", phone)

for _ in range(240):                      # 20 minutes
    s = call(action="getStatus", id=num_id)
    if s.startswith("STATUS_OK"):
        print("Code:", s.split(":")[1])
        call(action="setStatus", id=num_id, status=6)
        break
    time.sleep(5)

Perguntas frequentes sobre a API

A API oferece números de 1,255 serviços em 145 países pelo mesmo preço da interface web.

O que é a API de autenticação por SMS?
Funcionalidade para comprar números virtuais, verificar códigos e cancelar via requisições HTTP. A API da SNSSIM segue o padrão handler_api do setor.
Posso continuar usando o mesmo programa que usava em outros sites de verificação por SMS?
Se você usa um programa compatível com handler_api, basta alterar o endereço base e a chave API para se conectar imediatamente.
Há custos adicionais para a API?
Não há diferença. A API e a interface web usam o mesmo crédito e preços.
Quantas solicitações são permitidas?
Até 300 solicitações por minuto por chave API. Excedendo isso, ocorrerá o erro TOO_MANY_REQUESTS e o crédito não será deduzido.
Números comprados via API são reembolsáveis?
Sim. Se o código não chegar em 20 minutos, números comprados via API também são reembolsados automaticamente em créditos.
Onde posso criar uma chave API?
Gere na seção API após login. A chave é exibida apenas uma vez - salve-a imediatamente.

Crie uma chave API e conecte-se imediatamente

Após cadastro, adicione crédito para gerar sua chave API diretamente na conta.

API de verificação por SMS | SNSSIM