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.online/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
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 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
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) 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:

167.235.198.205
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