La API es el protocolo de comunicación entre su software y nuestro servidor de activación.

La API se necesita para automatizar el proceso de recibir mensajes SMS en su lado usuario/cliente

Nuestra API es totalmente compatible con las páginas web de la competencia

Todas las solicitudes deben ir a https://sms-activate.ru/stubs/handler_api.php

Vía método POST o GET.

Todas las solicitudes deben tener una clave API como parámetro "api_key"

Descargue la implementación lista del protocolo en php

API de activación

Solicite la cantidad de números disponibles:

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country&operator=$operator

PARÁMETROS

$api_key - clave API

$country * - país del número ver tabla

* (no es necesario, si no se especifica, en su defecto se entregará la cantidad de acuerdo con la configuración en el menú de la izquierda).

$operator * - operador de número de teléfono móvil (disponible solo para **):

Rusiamegafon, mts, beeline, tele2, rostelecom, any
Ucraniakyivstar, life, utel, mts, vodafone
Kazajstántele2, beeline, aktiv, altel

* campo opcional. Si no se especifica, por defecto, la cantidad se mostrará de acuerdo con la configuración en el menú de la izquierda.

** disponible para$country = 0, $country = 1, $country = 2

Respuesta:

La respuesta del servidor será en formato json, ejemplo:

{"vk_0":74,"ok_0":188,"wa_0":223,"vi_0":68,"tg_0":27,"wb_0":179,"go_0":249,"av_0":23,"av_1":89,"fb_0":31}

Hasta dónde va el guión: el nombre del servicio, después va una indicación sobre si se necesita activar el desvío. 0 - no. 1 - sí.

Lista completa de servicios.

Consultar el saldo:

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=getBalance

Consultar el saldo junto con cashback

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=getBalanceAndCashBack

PARÁMETROS

$api_key - clave API

Respuesta:

ACCESS_BALANCE:'el saldo'

Posibles errores:

BAD_KEY - Clave API-erronea

ERROR_SQL - error del servidor SQL

Pedir el número:

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&forward=$forward&operator=$operator&ref=$ref&country=$country

PARÁMETROS

$api_key - clave API

$service - el servicio para pedirlo ver tabla

$forward * - Necesito solicitar un número redirigido

* parámetro opcional acepta  0(no realizar , establecido por defecto),  1(llevar a cabo)

$operator * - operador de número de teléfono móvil (disponible solo para **):

Rusiamegafon, mts, beeline,tele2,any
Ucraniakyivstar,life,utel,mts,vodafone
Kazajstántele2,beeline,aktiv,altel

* (no es necesario, si no se especifica, en su defecto se entregará la cantidad de acuerdo con la configuración en el menú de la izquierda).

** disponible para$country = 0, $country = 1, $country = 2

$ref - Pase el identificador de referencia. Más detalle

$country - país del número ver tabla

Al recibir el número a través de la API, confirma su acuerdo con reglas del proyecto

RESPUESTAS

NO_NUMBERS - no hay números

NO_BALANCE - sin saldo

ACCESS_NUMBER:$id:$number , donde ($id - id operaciones,$number - número de teléfono)

Posibles errores:

BAD_ACTION - una acción incorrecta

BAD_SERVICE - nombre de servicio incorrecto

BAD_KEY - Clave API-erronea

ERROR_SQL - error del servidor SQL

BANNED:'YYYY-m-d H-i-s' - hora por la cual la cuenta está bloqueada

Cambio de estado de activación

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id&forward=$forward

PARÁMETROS

$api_key - clave API

$id - id de activación

$forward * - número de teléfono para ser redirigido a

* Obligatorio solo si el parámetro forward = 1 se pasó con getNumber.

$status - estado de activación:

1avisar cuando esté listo el número (SMS al número está enviado)
3solicitar un código más (gratis)
6llevar a acabo activación (si hubo un estado "código recibido" - marca que tuvo éxito y lleva a cabo, si hubo una "preparación" - elimina y marca un error, si hubo un estado "esperando repetición" - pasa la activación a la espera de SMS)*
8reportar el número utilizado y cancelar la activación

* si hubo un estado 'código recibido' - marca con éxito y completa, si hubo una 'preparación' - elimina y marca un error, si hubo un estado 'en espera de reintento' - traduce la activación pendiente de SMS.

Lógica simple de la cronología api:

Obtenga el número usando el método getNumber
Después de esto, están disponibles las siguientes acciones:
8 - Cancelar la activación (si el número no le conviene)
1 - Informar que se ha enviado un SMS (opcional)
Para activar con el estado 1:
cancelar la activación
Inmediatamente después de recibir el código:
3 - Solicitar otro SMS
6 - Confirma el código SMS y completa la activación
Para activar con el estado 3:
6 - Confirma el código SMS y completa la activación

RESPUESTAS

ACCESS_READY - disponibilidad del número confirmada

ACCESS_RETRY_GET - esperando un nuevo sms

ACCESS_ACTIVATION - servicio activado correctamente

ACCESS_CANCEL - activación cancelada

Posibles errores:

ERROR_SQL - error del servidor SQL

NO_ACTIVATION - id la activación no existe

BAD_SERVICE - nombre de servicio incorrecto

BAD_STATUS - estado incorrecto

BAD_KEY - Clave API-erronea

BAD_ACTION - una acción incorrecta

Recibir el estado de activación:

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

PARÁMETROS

$api_key - clave API

$id - id de activación

RESPUESTAS

STATUS_WAIT_CODE - esperando un sms

STATUS_WAIT_RETRY:'código pasado inadecuado' - esperando el refinamiento del código

STATUS_WAIT_RESEND - esperando el reenvío de SMS *

* el software debe hacer clic en enviar SMS nuevamente y cambiar el estado a  6

STATUS_CANCEL - activación cancelada

STATUS_OK:'código de activación' - código recibido

Posibles errores:

NO_ACTIVATION - id la activación no existe

ERROR_SQL - error del servidor SQL

BAD_KEY - Clave API-erronea

BAD_ACTION - una acción incorrecta

Obtener precios actuales por país

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

PARÁMETROS

$api_key - clave API

$service - nombre corto del servicio (opcional, por defecto todos los servicios) ver tabla

$country - nombre del código de país (opcional, el valor predeterminado es todos los países) ver tabla

RESPUESTAS

JSON: un objeto en el formato

{"País":{"Servicio":{"cost":Coste,"count":Cantidad}}}

Obtenga una cartera digital para recargar en saldo para Qiwi

Puede integrar este método con su API de pago para la billetera qiwi y reponer su cuenta en el sitio de forma completamente automática

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=getQiwiRequisites

PARÁMETROS

$api_key - clave API

RESPUESTAS

JSON - objeto в формате

{"status":"статус","wallet":"PAGO NÚMERO DE BILLETERO","upToDate":"FECHA A LA QUE LOS DETALLES SON ACTUALES","comment":"COMENTARIO ESPECIFICADO EN PAGO"}

ATENCION! Los detalles a veces cambian y son válidos solo hasta la fecha en upToDate, para actualizar los detalles, pregunte nuevamente.

El status se puede tomar los valores:

successel pago puede hacerse
falsepagos qiwi no son posibles

Servicio adicional para números redirigidos

Después de recibir el primer SMS para números redirigidos, puede comprar otros servicios relacionados, como Yula, Yandex, Avito, cualquier otro

El costo del servicio adicional es de solo 5p.

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=getAdditionalService&service=$service&id=$id

PARÁMETROS

$api_key - clave API

$service - nombre corto del servicio ver tabla

$id - ID de activación de padres

RESPUESTAS

ADDITIONAL:$id:$phone - Creó con éxito una nueva activación. Donde ID - ID de activación adicional, teléfono - número de teléfono

Posibles errores:

WRONG_ADDITIONAL_SERVICE - Servicio adicional no válido (solo se permiten servicios de redirección)

WRONG_ACTIVATION_ID - ID de activación de padre no válido

WRONG_SECURITY - Se produjo un error al intentar transferir una identificación de activación sin reenvío, o una activación completa / inactiva

REPEAT_ADDITIONAL_SERVICE - Se produce un error al intentar ordenar un servicio comprado nuevamente

NO_BALANCE - No hay suficiente dinero

ERROR_SQL - Error de la base de datos, contacte al soporte

API de arrendamiento

Solicitar países y servicios disponibles

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=getRentServicesAndCountries&rent_time=$time&operator=$operator&country=$country

PARÁMETROS

$api_key - clave API

$time * - tiempo de alquiler

* parámetro opcional Si no se especifica, el valor predeterminado será 1 hora.

$operator * - operador de número de móvil

$country * - país (predeterminado: Rusia)

* parámetro opcional Si no se especifica, por defecto será cualquiera.

Respuesta:

La respuesta del servidor será en formato json, ejemplo:

{ "countries": { "0": 0 }, "operators": { "0": "aiva", "1": "any", "2": "beeline", ... "16": "yota" }, "services": { "full": { "cost": 42.93, "quant": 20 }, "vk": { "cost": 21.95, "quant": 20 }, "ok": { "cost": 7.68, "quant": 55 }, "ot": { "cost": 5.2, "quant": 42 } } }

Posibles errores:

BAD_KEY - Clave API-erronea

Reserva de habitaciones en alquiler

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=getRentNumber&service=$service&rent_time=$time&operator=$operator&country=$country&url=$url

PARÁMETROS

$api_key - clave API

$service - servicio para el que necesita obtener un número

$time * - tiempo de alquiler (predeterminado: 1 hora)

$operator * - operador de número de teléfono móvil (Predeterminado: Cualquiera)

$country * - país (predeterminado: Rusia)

$url * - enlace para webhook (no se considera de forma predeterminada)¿Qué es webHook?

* parámetro opcional Si no se especifica, se usará la opción predeterminada.

Respuesta:

La respuesta del servidor será en formato json, ejemplo:

{ "status": "success", "phone": { "id": 1049, "endDate": "2020-01-31T12:01:52", "number": "79959707564" } }

Posibles errores:

BAD_KEY - Clave API-erronea

Responda en formato json:

{ "status": "error", "message": "*possible_answer*" }

Возможные ответы в поле "message":

BAD_SERVICE - servicio no especificado o nombre incorrecto

NO_BALANCE - no hay dinero en la cuenta

NO_NUMBERS - no hay habitaciones disponibles

ACCOUNT_INACTIVE - no hay habitaciones disponibles

SQL_ERROR - error del servidor SQL

Obtener estado para alquilar

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=getRentStatus&id=$id

PARÁMETROS

$api_key - clave API

$id - Identificación de alquiler recibida en la respuesta al ordenar una habitación

Respuesta:

La respuesta del servidor será en formato json, ejemplo:* :

{ "status": "success", "quantity": "2", "values": { "0": { "phoneFrom": "79180230628", "text": "5", "service": "ot", "date": "2020-01-30 14:31:58" }, "1": { "phoneFrom": "79180230628", "text": "4", "service": "ot", "date": "2020-01-30 14:04:16" } } }

* exitoso solo si hay un SMS (campo 'cantidad'> 0).

Posibles errores:

BAD_KEY - Clave API-erronea

Responda en formato json:

{ "status": "error", "message": "*possible_answer*" }

Posibles respuestas en el campo "message":

NO_ID_RENT - Id. De arrendamiento no especificado

INVALID_PHONE - usted no alquila el número (identificación de alquiler incorrecta)

STATUS_FINISH - alquiler pagado y completado

STATUS_CANCEL - alquiler cancelado con reembolso

STATUS_WAIT_CODE - esperando los primeros sms

Cambio de estado de alquiler

https://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=setRentStatus&id=$id&status=$status

PARÁMETROS

$api_key - clave API

$id - Identificación de alquiler recibida en la respuesta al ordenar una habitación

$status - código para cambiar el estado (número)

El status se puede tomar los valores:

1Línea de meta
2Cancelar

Respuesta:

La respuesta del servicio estará en formato json:

{ "status": "success" }

Posibles errores:

BAD_KEY - Clave API-erronea

Ответ в json формате:

{ "status": "error", "message": "*possible_answer*" }

Posibles respuestas en el campo "message":

NO_ID_RENT - Id. De arrendamiento no especificado

INCORECT_STATUS - estado perdido o incorrecto

CANT_CANCEL - Es imposible cancelar el alquiler (más de 20 minutos)

INVALID_PHONE - usted no alquila el número (identificación de alquiler incorrecta)

ALREADY_FINISH - el alquiler ya se completó

ALREADY_CANCEL - alquiler ya cancelado

SQL_ERROR - error del servidor SQL

                    <?php
                    include_once ("smsactivateApi.php");//Inclusión de una clase en un proyecto.

                        $sms = new SMSActivate($API_KEY);//Crear instancia de clase SMSActivate

$freeSlots = $sms->getNumbersStatus(0, 'tele2');//Obtenga el número de números disponibles para el país de Rusia y el operador de tele2 echo "Номеров Вконтакте: " . $freeSlots['vk']."\n";//Show for Vk
echo "Номеров Whatsapp: " . $freeSlots['wa']."\n";//Show para whatsapp
var_dump($freeSlots); //Mostrar todos los servicios con cantidad
$balance = $sms->getBalance();//Obtener el equilibrio echo "En la cuenta " . $balance." rub." ."\n";//Mostrar saldo
$balance = $sms->getBalanceAndCashBack();//Obtenga un saldo de reembolso echo "En la cuenta " . $balance." rub." ."\n";//Mostrar saldo de devolución
$number = $sms->getNumber('ok',0, 0, 'tele2');//Obtenga el número Odnoklassniki sin reenviar echo "Activación № " . $number['id']. "el telefono ". $number['number'] \n";//Mostrar id y número de activación
try{ $newNumber = $sms->getNumber('vk',0, 1); echo $newNumber['number'] ."\n"; } catch (Exception $e) { echo $e->getResponseCode() ."\n"; }//Captura un código de error (por ejemplo, NO_BALANCE)
$status = $sms->setStatus($number['id'], 3);//Cambiar el estado de activación por id (obtener 1 código más) try{ $status = $sms->getStatus($number['id']);//Obtener estado de activación por id if ($status['status'] === 'STATUS_OK' && $status['code']) echo "Ваш код: " .$status['code']; } catch (Exception $e) { echo $e->getResponseCode() ."\n"; }//Captura el código de error $prices = $sms->getPrices(1, 'vk');//Obtenga el precio real del servicio. echo "Precio por VK (Ucrania) : " .$prices[1]['vk']['cost']." rub. ". $prices[1]['vk']['count'];//Mostrar resultado $newQiwi = $sms->getQiwiRequisites();//Obtenga una cartera digital para recargar en saldo para Qiwi if ($newQiwi['status'] === 'success') echo "Número de billetera " . $newQiwi['wallet']."\n";//3 - Solicitar otro SMS $getAvailableRentNumbers = $sms->getRentServicesAndCountries('2');//Solicite los países disponibles para alquiler y servicios (durante 2 horas para todos los operadores) echo "Alquiler completo - Costo:" . $getAvailableRentNumbers['services']['full']['cost'] . " Cantidad :" .$getAvailableRentNumbers['services']['full']['quant'] ." \n"; //Mostrar información completa de precios
foreach( $getAvailableRentNumbers['operators'] as $value) { echo " Operador " . $value ."\n"; }//Operadores de listas
$getRentNumber = $sms->getRentNumber('vk','10','0','yota');//Obtenga un número de alquiler para Vkontakte durante 10 horas, el operador 'Yota', país - Rusia if ($getRentNumber['status'] === 'success'){ echo "El alquiler fue exitoso! Su numero: " . $getRentNumber['phone']['number']." \nFecha de finalización del alquiler : ". $getRentNumber['phone']['endDate']." \nNúmeros de identificación :" .$getRentNumber['phone']['id'] ; }//Mostrar información de alquiler
else echo "Код ошибки : " . $getRentNumber['message'];
$getRentStatus = $sms->getRentStatus($getRentNumber['phone']['id']);//Obtenga el estado del arrendamiento con la identificación del número recibido if ($getRentStatus['status'] == 'success'){ foreach( $getRentStatus['values']as $index => $value) { echo " Mensaje " . $index .": desde la sala - " . $value['phoneFrom'] . "servicio - " . $value ['service'] . "mensaje de texto - " . $value['text'] . "дата - " . $value['date']; } }//mostrar una lista de los mensajes recibidos al alquilar una habitación else echo "Código de error : " . $getRentStatus['message']; $setRentStatus = $sms->setRentStatus($getRentNumber['phone']['id'],1);//Establezca el estado de alquiler 'finalizar' con la identificación del número recibido if ($setRentStatus['status'] == 'success') echo " ¡El cambio de estado fue exitoso! "; else echo "Código de error : " . $setRentStatus['message'];
                    
                        <--Скоро-->