API de verificación por SMS

La API de SNSSIM maneja la compra de números, verificación de códigos, cancelación, consulta de crédito y precios en una sola solicitud HTTP. Utiliza el método handler_api estándar de la industria, por lo que solo necesitas cambiar la dirección y la clave API en tu programa existente para conectarte de inmediato.

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
Método estándar de la industria
handler_api

Método estándar de la industria

Por cada clave API
300 veces por minuto

Por cada clave API

País / Servicio
145 / 1,255

País / Servicio

Reembolso automático si no hay código
20 minutos

Reembolso automático si no hay código

¿Cómo obtengo una clave API?

Genera tu clave API en el menú correspondiente tras login. Solo se muestra una vez - guárdala. Usa el mismo saldo y precios que en la web.

¿Cuál es la dirección base?

Todas las peticiones se envían por GET a la misma URL añadiendo api_key y action.

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

¿Qué tipo de solicitudes puedo enviar?

Disponibles 7 tipos de solicitudes: compra de números, verificación de códigos, cancelación y consulta de saldo.

actionQué hacemosEjemplo de respuesta
getBalanceConsultar saldoACCESS_BALANCE:12.50
getPrices&service=telegram&country=gbPrecios y números disponibles por servicio y país{"gb":{"telegram":{"cost":0.207,"count":8877728}}}
getNumber&service=telegram&country=gbComprar númeroACCESS_NUMBER:ID:PHONE
getStatus&id=IDConsultar códigoSTATUS_WAIT_CODE / STATUS_OK:CODE
setStatus&id=ID&status=8Cancelar número (reembolso total si no se recibe el código)ACCESS_CANCEL
setStatus&id=ID&status=3Recibir otro código al mismo númeroACCESS_RETRY_GET
setStatus&id=ID&status=6Finalizar usoACCESS_ACTIVATION

Parámetros de la solicitud

NombreObligatorioDescripción
api_keyTodosClave API creada en la pantalla de tu cuenta
actionTodosgetBalance, getPrices, getNumber, getStatus, setStatus
servicegetNumberCódigo de servicio (ej: telegram, whatsapp, google). Coincide con los valores en la lista de servicios.
countrygetNumberCódigo de país de 2 letras (ejemplo: gb, us, id)
idgetStatus, setStatusID del número emitido en getNumber (comienza con N)
statussetStatus8 para cancelar, 3 para solicitar código nuevamente, 6 para terminar, 1 para preparar

Texto de respuesta y significado

Las respuestas se proporcionan en texto breve. También se indica si se deducen créditos.

RespuestaSignificadoDinero
ACCESS_NUMBER:ID:PHONENúmero recibidoSe cobra el precio del número
STATUS_WAIT_CODEEsperando el códigoSin cambios
STATUS_OK:CODECódigo recibidoPago completado
STATUS_WAIT_RETRY:CODEEstoy esperando un código de verificación adicional (incluyendo el código anterior)Sin coste extra
STATUS_CANCELCancelado o tiempo terminadoReembolsado si no hubo código
ACCESS_CANCELCanceladoReembolso total
ACCESS_RETRY_GETEsperando otro código en el mismo númeroSin coste extra
ACCESS_ACTIVATIONHas terminado de usar el númeroSin cambios
NO_BALANCERecarga y recibe al instanteSin cargo
NO_NUMBERSActualmente no podemos proporcionar números de este país.Sin cargo
NO_ACTIVATIONSTienes 20 números activosSin cargo
EARLY_CANCEL_DENIEDPara números que han recibido el código de verificación, selecciona Finalizar (6) en lugar de CancelarSin cambios
BAD_KEYLa clave API no es correctaSin cargo
BAD_SERVICE / BAD_COUNTRYEl código de servicio o país es incorrectoSin cargo
NO_ACTIVATIONNo se encontró el ID del númeroSin cambios
TOO_MANY_REQUESTSSuperaste las 300 por minutoSin cargo

¿Cuál es el flujo para recibir códigos por API?

4 pasos: recibir número, ingresarlo, verificar código y completar.

  1. 1 pasos

    Obtener número

    Selecciona el servicio y país que deseas en getNumber para obtener un número.

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

    Ingresar número

    Ingresa el número comprado en la página de registro o en el programa.

    +44 7700 900123
  3. 3 pasos

    Consultar código

    Llama a getStatus cada 5 segundos para verificar si ha llegado el código.

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

    Finalizar

    Después de ingresar el código, completa con setStatus 6. Si no hay código en 20 minutos, reembolso automático.

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

Ejemplos por lenguaje

Proceso completo: recibir número, esperar código y finalizar. Cambia el idioma tocando la pestaña.

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)

Preguntas frecuentes sobre la API

La API ofrece números de 145 países y 1,255 servicios al mismo precio que la interfaz web.

¿Qué es la API de verificación por SMS?
Funcionalidad para comprar números virtuales, ver códigos y cancelar mediante HTTP requests. La API de SNSSIM usa el estándar handler_api.
¿Puedo seguir usando el mismo programa que usaba en otros sitios de verificación SMS?
Si tu programa utiliza el método handler_api, solo necesitas cambiar la dirección base y la clave API para conectarte inmediatamente.
¿Hay tarifas adicionales para la API?
No hay diferencia. La API y la interfaz web usan el mismo crédito y precios.
¿Cuántas solicitudes se pueden hacer?
Se permiten hasta 300 solicitudes por minuto por clave API. Si se excede, se genera el error TOO_MANY_REQUESTS y no se deduce crédito.
¿Se reembolsan los números comprados por API?
Sí. Si el código no llega en 20 minutos, el número comprado a través de la API también se reembolsará automáticamente como crédito.
¿Dónde se crea la clave API?
Genera la clave en el menú API de tu cuenta tras login. Solo se muestra una vez al crear - guárdala inmediatamente.

Conéctate inmediatamente después de generar la clave API

Después de registrarte, recarga crédito para generar una clave API directamente en la pantalla de la cuenta.

API de verificación por SMS | SNSSIM