API

Documentación API

La API es el protocolo que permite la comunicación entre su software y nuestro servidor de activaciones .

La API es necesaria para la automatización del proceso de recepción de SMS, OTP y PVA en su lado.

Nuestra API es totalmente compatible con sitios competidores.
Todas las solicitudes deben enviarse a https://smsbower.page/stubs/handler_api.php
por POST o GET.

Todas las solicitudes deben incluir una clave API como parámetro 'api_key'

Consultar saldo
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getBalance
Copiado

Parámetros $api_key - Su clave API

Respuesta
ACCESS_BALANCE:saldo de cuenta

Errores posibles
BAD_KEY - clave API inválida

Respuesta
ACCESS_BALANCE:$yourBalance

Solicitar número
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getN
umber&service=$service&country=$country&maxPrice=$maxPrice
&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds
&phoneException=$phoneException&ref=$ref
&userID=$userID&minPrice=$minPrice
Copiado

Parámetros $api_key - Su clave API $service - servicio (ver tabla) ver tabla $country - país del número ver tabla $maxPrice - precio máximo que está dispuesto a pagar por un número $providerIds - Lista de proveedores desde los que se harán compras, separados por comas (1,2,3) $exceptProviderIds - Lista de proveedores excluidos de la compra de números, separados por comas (1,2,3) $phoneException - excluyendo prefijos para números. Separe con comas. Formato: código de país y de 3 a 6 dígitos de la máscara (ejemplo: 7918,7900111) $ref - transferir el ID de referido $userID - nuevo parámetro para revendedores, por favor contacte con el soporte para más detalles $minPrice - el precio mínimo al que estás dispuesto a comprar un número Al obtener el número mediante la API, acepta las reglas del proyecto

Respuesta ACCESS_NUMBER:$activationId:$phoneNumber

Errores posibles BAD_KEY - clave API inválida BAD_ACTION - acción incorrecta BAD_SERVICE - nombre de servicio incorrecto

Solicitar código SMS
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id
Copiado

Parámetros $api_key - Su clave API $id - id de activación

Respuesta
STATUS_WAIT_CODE - Esperando SMS STATUS_WAIT_RETRY:$lastCode - Esperando siguiente SMS STATUS_CANCEL - Activación cancelada STATUS_OK: 'activation code' - código SMS recibido

Errores posibles
BAD_KEY - clave API inválida BAD_ACTION - acción incorrecta NO_ACTIVATION - id de activación no existe

Cambio de estado de activación
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=setSt
atus&status=$status&id=$id
Copiado
Parámetros $api_key - Su clave API $id - id de activación $status - estado de activación
1 - informar sobre la disponibilidad del número (SMS enviado al número) 3 - solicitar otro código (gratis) 6 - completar activación * 8 - informar que el número ha sido usado y cancelar la activación

Lógica simple de cronología del API:

Obtenga el número usando el método getNumber, luego estarán disponibles las siguientes acciones: 8 - Cancelar la activación (si el número no le conviene) 1 - Informar que se envió el SMS (opcional)

Para activaciones con estado 1: 8 - Cancelar activación

Inmediatamente después de recibir el código: 3 - Solicitar otro SMS 6 - Confirmar código SMS y completar activación

Para activaciones con estado 3: 6 - Confirmar código SMS y completar activación

Respuesta ACCESS_READY - el teléfono está listo para recibir SMS ACCESS_RETRY_GET - esperando un nuevo SMS ACCESS_ACTIVATION - el servicio ha sido activado exitosamente ACCESS_CANCEL - activación cancelada

Errores posibles
NO_ACTIVATION - id de activación no existe BAD_STATUS - estado incorrecto BAD_KEY - clave API inválida BAD_ACTION - acción incorrecta EARLY_CANCEL_DENIED - Es posible cancelar el número después de 2 minutos de la compra

Obtener precios
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getP
rices&service=$service&country=$country
Copiado

Parámetros $api_key - Su clave API $service - nombre del servicio (Opcional, por defecto todos los servicios) ver tabla ver tabla $country - nombre de código (Opcional, por defecto todos los países) ver tabla

Respuesta
JSON - objeto en formato

{''País'':
        {''Servicio'':
            {
                ''cost'':Costo,'
                'count'':Cantidad
            }
        }
}
                                                
                                            

Lista de servicios
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getServicesList
Copiado

Parámetros $api_key - Su clave API

Respuesta
JSON - objeto en formato


    {
        "status": "success",
        "services": [
            {
                "code": "kt",
                "name": "KakaoTalk"
            }
        ]
    }

                                        

Lista de países
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getCountries
Copiado

Parámetros $api_key - Su clave API

Respuesta
JSON - objeto en formato


    {
        {
            "id": 1003
            "rus": "Бермуды"
            "eng": "Bermuda"
            "chn": "百慕大"
        }
    }

                                        

Solicitar númeroV2

Este método funciona similar al método getNumber, acepta los mismos parámetros pero devuelve información adicional de activación .

https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getN
umberV2&service=$service&country=$country&maxPrice=$maxPrice
&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds
&userID=$userID&minPrice=$minPrice
Copiado

Parámetros api_key - Su clave API $service - servicio (ver tabla) ver tabla $country - país del número ver tabla $maxPrice - precio máximo que está dispuesto a pagar por un número $providerIds - Lista de proveedores desde los que se harán compras, separados por comas (1,2,3) $exceptProviderIds - Lista de proveedores excluidos de la compra de números, separados por comas (1,2,3) $userID - nuevo parámetro para revendedores, por favor contacte con el soporte para más detalles $minPrice - el precio mínimo al que estás dispuesto a comprar un número Al obtener el número mediante la API, acepta las reglas del proyecto

Respuesta

Si la solicitud es exitosa, la respuesta será en el siguiente formato .

{
               "activationId": "id",
               "phoneNumber": number,
               "activationCost": activationCost,
               "countryCode": countryCode,
               "canGetAnotherSms": canGetAnotherSms,
               "activationTime": activationTime,
               "activationOperator": activationOperator,
}
Copiado

Errores posibles BAD_KEY - clave API inválida BAD_ACTION - acción incorrecta BAD_SERVICE - nombre de servicio incorrecto

Obtener lista completa de precios v2
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getP
ricesV2&service=$service&country=$country
Copiado

Parámetros api_key - Su clave API $service - servicio ver tabla $country - país del número ver tabla

Ejemplo de respuesta
"país": {
    "servicio": {
            "precio1": cantidad,
            "precio2": cantidad,
            "precio3": cantidad,
          }
     },
            
Copiado

Errores posibles BAD_KEY - clave API inválida BAD_ACTION - acción incorrecta BAD_SERVICE - nombre de servicio incorrecto

Obtener lista completa de precios v3
https://smsbower.online/stubs/handler_api.php?api_key=$api_key&action=getP
ricesV3&service=$service&country=$country
Copiado

Parámetros api_key - Su clave API $service - servicio ver tabla $country - país del número ver tabla

Ejemplo de respuesta
"país": {
    "servicio": {
            "provider 1 id": {
                count: cantidad,
                price: precio,
                provider_id: provider id,
          },
            "provider 2 id": {
                count: cantidad,
                price: precio,
                provider_id: provider id,
          },
          "provider 3 id": {
                count: cantidad,
                price: precio,
                provider_id: provider id,
          },
          }
     },
            
Copiado

Errores posibles BAD_KEY - clave API inválida BAD_ACTION - acción incorrecta BAD_SERVICE - nombre de servicio incorrecto BAD_COUNTRY - nombre de país incorrecto

Get static wallet
https://smsbower.online/api/payment/getActualWalletAddress?api_key=$api_key&coin=$coin
&network=$network
Copiado

Parámetros api_key - Su clave API $coin - coin (usdt, trx) $network - network number (tron)

Ejemplo de respuesta
    {
        "wallet_address": "TFGMAwTfxtxKvy1mTTHr7XJaXeumjdmhGg"
    }
Copiado
Notificación vía Webhook

Webhook es un mecanismo para notificar automáticamente a un sistema sobre eventos. Después de adquirir un número, no es necesario consultar constantemente el servidor para ver si hay mensajes SMS entrantes. Podemos enviar inmediatamente su contenido a la dirección (o múltiples direcciones) que especifique en la configuración.

Direcciones IP para las solicitudes de Webhook

Para asegurar el correcto funcionamiento de las notificaciones y evitar su pérdida, agregue las siguientes direcciones IP a la lista blanca de fuentes permitidas en su servidor:

Los webhooks para activaciones y alquileres vendrán de las siguientes direcciones:

Copiado

Asegúrese de que su servidor acepte solicitudes entrantes de estas IPs.

Notificaciones de SMS entrantes

Si la URL del Webhook https://your-site.com/webhook.php se especifica en su perfil, haremos una solicitud POST a esa dirección en el siguiente formato cuando se reciba un mensaje SMS:

Ejemplo de datos en la solicitud
{
    "activationId": 123456,
    "service": "go",
    "text": "Sms text",
    "code": "12345",
    "country": 2,
    "receivedAt": "2023-01-01 12:00:00"
}
Copiado


Respuesta del Servidor

Su script debe devolver un estado HTTP de 200.

  • - Si el servidor no responde, se realizarán 2 solicitudes de reintento después de 1 minuto y luego después de 5 minutos.
  • - En caso de 3 intentos fallidos, recibirá una notificación y verá errores en su profile.

Puede habilitar o deshabilitar Webhooks en su profile settings.

Example Postman