API

API de activación por SMS

Compra números y lee códigos desde tus propios scripts. La API utiliza el formato común de activación por SMS, por lo que la mayoría de los clientes existentes funcionan cambiando la dirección base y la clave.

Crea tu clave API en la página de claves API de la consola. Se muestra una sola vez.

Obtener clave API Registrarse

Dirección base y clave

Envía solicitudes GET o POST a la dirección base con api_key y action. Crea la clave en la página Clave API de la consola; se muestra una sola vez.

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

Los códigos de servicio son los nombres en nuestras páginas de servicio (por ejemplo whatsapp, telegram, google). Los códigos de país son códigos ISO en minúsculas (us, gb, in). Límite: 300 solicitudes por minuto por clave. Cada activación tiene un período de 20 minutos, igual que en la consola.

getBalance

Tu saldo en USD.

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

ACCESS_BALANCE:12.50

getServicesList

Códigos de servicio que puedes 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) y códigos de marcación (JSON).

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

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

getPrices

Precios en USD y cantidades disponibles por país y servicio. Ambos filtros son opcionales.

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 una activación. Devuelve el ID de activación y el número con su 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 (sin código aún), STATUS_OK:<code>, STATUS_WAIT_RETRY:<último código> (se solicitó otro código), STATUS_CANCEL (cancelado o reembolsado).

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

STATUS_OK:482913

setStatus

status=1 listo (ACCESS_READY), 3 otro código (ACCESS_RETRY_GET), 6 finalizar (ACCESS_ACTIVATION), 8 cancelar con reembolso completo si no llegó código (ACCESS_CANCEL).

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

ACCESS_RETRY_GET

Flujo típico

getNumber con el servicio y país. Guarda el ID.
Ingresa el número en la app y solicita el SMS.
Llama a getStatus cada 5 a 10 segundos hasta STATUS_OK.
¿Necesitas otro SMS? setStatus 3, luego getStatus nuevamente. Listo: setStatus 6.
¿Sin código? setStatus 8 cancela con reembolso completo. Sin llamada, el reembolso ocurre automáticamente al terminar el período.

Errores

BAD_KEY	Clave API faltante o incorrecta.
BAD_ACTION	Acción desconocida.
BAD_SERVICE	Código de servicio desconocido.
BAD_COUNTRY	El servicio no se vende en ese país.
NO_BALANCE	Saldo insuficiente.
NO_NUMBERS	No hay números disponibles ahora. Intenta de nuevo en un momento.
NO_ACTIVATION	ID de activación desconocido o no te pertenece.
EARLY_CANCEL_DENIED	Ya llegó un código, por lo que no se puede cancelar la activación.
TOO_MANY_REQUESTS	Más de 300 solicitudes en un minuto.
NO_ACTIVATIONS	Ya hay 20 activaciones abiertas.