Documentación API - SMSBower
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
Example Postman