Elegir un idioma

El endpoint compatible con sms-activate

Sigue usando bots y paneles hechos para el protocolo sms-activate cambiando una sola URL. Acciones compatibles, formatos de identificadores y diferencias que conviene conocer.

En esta página
  1. Endpoint
  2. Ejemplo
  3. Acciones compatibles
  4. Identificadores
  5. Diferencias que conviene conocer

Muchas herramientas usan el protocolo sms-activate. SmsGrab ofrece un endpoint compatible, así que esas herramientas funcionan en cuanto cambias la URL base y usas tu clave de API de SmsGrab.

Endpoint

Texto
https://smsgrab.com/api/stubs/handler_api.php

Envía api_key y action junto con los parámetros de la acción, por GET o por POST. La clave también se puede enviar como Authorization: Bearer.

Ejemplo

Bash
curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getBalance"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getNumber&service=tg&country=6"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=getStatus&id=100000123"

curl -s "https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_KEY&action=setStatus&id=100000123&status=6"
Texto
ACCESS_BALANCE:12.34
ACCESS_NUMBER:100000123:6281234567890
STATUS_WAIT_CODE
STATUS_OK:482913
ACCESS_ACTIVATION

Acciones compatibles

Acción Qué hace
getBalance, getBalanceAndCashBack Tu saldo
getNumber, getNumberV2 Compra un número
setStatus 1 listo, 3 esperar otro SMS, 6 terminar, 8 cancelar y reembolsar
getStatus, getStatusV2 En espera, código recibido o cancelado
getActiveActivations Números que siguen activos
getPrices, getTopCountriesByService, getNumbersStatus Precios y stock
getCountries, getServicesList Países y servicios con sus identificadores

Identificadores

  • Los servicios usan los códigos cortos del protocolo cuando existen, como wa WhatsApp, tg Telegram, go Google, fb Facebook, ig Instagram y ds Discord. Nuestros propios identificadores de servicio también funcionan.
  • Los países usan los identificadores numéricos del protocolo cuando existen, como 0 Rusia, 6 Indonesia, 4 Filipinas, 22 India y 187 Estados Unidos. Nuestros identificadores y los códigos ISO también funcionan.
  • getCountries y getServicesList devuelven las listas completas y actualizadas.
  • El id de una activación es un número como 100000123, que también acepta la API REST.

Diferencias que conviene conocer

  • Los importes están en dólares estadounidenses, con dos decimales, a tu precio con el descuento mayorista incluido. No son rublos.
  • operator se ignora; se elige para ti la mejor oferta disponible.
  • Los errores se responden como en el protocolo original, con HTTP 200 y un texto como NO_NUMBERS, NO_BALANCE o BAD_KEY. Demasiadas peticiones reciben HTTP 429 con TOO_MANY_REQUESTS.
  • NO_ACCESS significa que a la clave le falta el ámbito purchase, que la dirección IP no está permitida o que se alcanzó el límite de gasto diario.
  • Los alquileres no están disponibles en este endpoint.

Todo lo demás es común con la API REST: las mismas claves, límites, precios, reembolsos y webhooks.

¿Te ha resultado útil este artículo?

¿Sigues necesitando ayuda?

Escríbenos. Respondemos a todos los mensajes, normalmente en pocas horas.

O escríbenos a support@smsgrab.com