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'
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
umber&service=$service&country=$country&maxPrice=$maxPrice
&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds
&phoneException=$phoneException&ref=$ref
&userID=$userID&minPrice=$minPrice
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
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
atus&status=$status&id=$id
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
rices&service=$service&country=$country
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
}
}
}
Parámetros $api_key - Su clave API
Respuesta
JSON - objeto en formato
{
"status": "success",
"services": [
{
"code": "kt",
"name": "KakaoTalk"
}
]
}
Parámetros $api_key - Su clave API
Respuesta
JSON - objeto en formato
{
{
"id": 1003
"rus": "Бермуды"
"eng": "Bermuda"
"chn": "百慕大"
}
}
Este método funciona similar al método getNumber, acepta los mismos parámetros pero devuelve información adicional de activación .
umberV2&service=$service&country=$country&maxPrice=$maxPrice
&providerIds=$providerIds&exceptProviderIds=$exceptProviderIds
&userID=$userID&minPrice=$minPrice
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
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,
}
Errores posibles BAD_KEY - clave API inválida BAD_ACTION - acción incorrecta BAD_SERVICE - nombre de servicio incorrecto
ricesV2&service=$service&country=$country
Parámetros api_key - Su clave API $service - servicio ver tabla $country - país del número ver tabla
"país": {
"servicio": {
"precio1": cantidad,
"precio2": cantidad,
"precio3": cantidad,
}
},
Errores posibles BAD_KEY - clave API inválida BAD_ACTION - acción incorrecta BAD_SERVICE - nombre de servicio incorrecto
ricesV3&service=$service&country=$country
Parámetros api_key - Su clave API $service - servicio ver tabla $country - país del número ver tabla
"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,
},
}
},
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
&network=$network
Parámetros api_key - Su clave API $coin - coin (usdt, trx) $network - network number (tron)
{
"wallet_address": "TFGMAwTfxtxKvy1mTTHr7XJaXeumjdmhGg"
}
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:
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:
{
"activationId": 123456,
"service": "go",
"text": "Sms text",
"code": "12345",
"country": 2,
"receivedAt": "2023-01-01 12:00:00"
}
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.