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 * - números de operador móvil, puede especificar varios números separados por comas (disponible solo para **):

Rusia megafon, 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":153,"ok_0":118,"wa_0":55,"vi_0":190,"tg_0":250,"wb_0":256,"go_0":138,"av_0":174,"av_1":204,"fb_0":156}

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

* devuelve el saldo, teniendo en cuenta el reembolso acumulado, si la casilla de verificación está marcada en la configuración de la cuenta de reembolso  "Gastar reembolso de activación"

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&phoneException=$phoneException

PARÁMETROS

$api_key - clave API

$service - el servicio para pedirlo ver tabla

$forward * - Necesito solicitar un número redirigido

$phoneException * - excluyendo prefijos para números rusos. Especifique con comas. Formato de grabación: código de país y de 3 a 6 dígitos de la máscara (por ejemplo 7918,7900111). El valor predeterminado es el establecido en el menú de la izquierda.

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

$operator * - números de operador móvil, puede especificar varios números separados por comas (disponible solo para **):

Rusiamegafon, mts, beeline,tele2,any
Ucrania kyivstar,life,utel,mts,vodafone
Kazajstán tele2,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

WRONG_EXCEPTION_PHONE - prefijos de exclusión no válidos

NO_BALANCE_FORWARD - fondos insuficientes para comprar desvío de llamadas

Solicitar un número para varios servicios

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

PARÁMETROS

$api_key - clave API

$service - Servicios para pedidos. Especifique separados por comas, por ejemplo "vk, ok, vi, av" ver tabla

$forward * - Necesito solicitar un número redirigido

* parámetro opcional, los caracteres de reenvío se especifican separados por comas, el número de dígitos de reenvío debe coincidir con el número de servicios transmitidos en el parámetro $service Se permite transmitir solo 1 servicio con redireccionamiento, por ejemplo "0,1,0,0" - correcto, "0,1,1,0" - incorrecto. Acepta 0(no realizar , establecido por defecto),  1(llevar a cabo)

$operator * - números de operador móvil, puede especificar varios números separados por comas (disponible solo para **):

Rusia megafon, mts, beeline,tele2,any
Ucrania kyivstar,life,utel,mts,vodafone
Kazajstán tele2,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).

$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

{{'phone':phone,'activation':activation,'service':service},{'phone':phone,'activation':activation,'service':service}}, donde (phone - id operaciones,activation - número de teléfono,service - Servicio)

Posibles errores:

BAD_ACTION - una acción incorrecta

BAD_SERVICE - nombre de servicio incorrecto

BAD_KEY - Clave API-erronea

BAD_FORWARD - redirección especificada incorrectamente

NOT_AVAILABLE - La compra multiservicio no está disponible para el país que está utilizando

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 sms de texto completo

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

PARÁMETROS

$api_key - clave API

$id - id de activación

RESPUESTAS

STATUS_WAIT_CODE - esperando un sms

STATUS_CANCEL - activación cancelada

FULL_SMS:texto completo 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 }},"retry":recepción repetida de SMS}

Obtenga una lista de todos los países

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

PARÁMETROS

$api_key - clave API

RESPUESTAS

JSON - objeto в формате

{{'Страна':{'id':0,'rus':"Россия","eng:"Russia","chn":"俄罗斯","visible":1,"retry":1,"rent":1,"multiService":1}},
donde (
id: id del país;
rus : nombre del país en ruso;
eng : nombre del país en inglés;
chn : nombre del país en chino;
visible: 0: el país no se muestra en el sitio, 1: se muestra;
retry: 0 - SMS repetidos NO está disponible, 1 - disponible;
rent: 0-país no alquilado, 1 - alquilado;
multiService: 0-country NO está disponible para multiservicio, 1- disponible.)

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:

success el pago puede hacerse
false pagos 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 * - números de operador de telefonía móvil, puede especificar varios números separados por comas

$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: 4 horas)

$operator * - números de operador móvil, puede especificar varios números separados por comas (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:

1 Línea de meta
2 Cancelar

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

Operadores de listas

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

PARÁMETROS

$api_key - clave API

Respuesta:

La respuesta del servicio estará en formato json:

{ "status": "success", "values": { "0": { "id": "123456", "phone": "79181234567" }, "1": { "id": "123457", "phone": "79181234568" } } }

Posibles errores:

BAD_KEY - Clave API-erronea

BAD_ACTION - una acción incorrecta

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

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

Posibles respuestas en el campo "message":

NO_NUMBERS - sin habitaciones alquiladas

SQL_ERROR - error del servidor SQL

Renovar el contrato

http://sms-activate.ru/stubs/handler_api.php?api_key=$api_key&action=continueRentNumber&id=$id&rent_time=$time

* La extensión de arrendamiento está disponible solo para el operador MTT. La vida útil del número es de 3 meses a partir de la fecha de la primera compra.

PARÁMETROS

$api_key - clave API

$id - id Alquiler

$time * - tiempo de alquiler (predeterminado: 4 horas)

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

Respuesta:

La respuesta del servicio estará en formato json:

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

Posibles errores:

BAD_KEY - Clave API-erronea

BAD_ACTION - una acción incorrecta

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

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

Posibles respuestas en el campo "message":

NO_ID_RENT - sin identificación de alquiler

NO_BALANCE - fondos insuficientes

RENT_DIE - el contrato de arrendamiento no se puede extender porque el número ha expirado

INVALID_PHONE - ID de arrendamiento no válido

WRONG_OPERATOR - arrendamiento transferido operador no MTT

INVALID_TIME - tiempo inadecuado. Horarios disponibles del 4 al 2016

SQL_ERROR - error del servidor SQL

Obtenga el costo de la renovación del contrato de arrendamiento

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

* este método solo está disponible para alquilar con el operador MTT.

PARÁMETROS

$api_key - clave API

$id - id Alquiler

Respuesta:

La respuesta del servicio estará en formato json:

{ "status": "success", "price": 6.33 }

Posibles errores:

BAD_KEY - Clave API-erronea

BAD_ACTION - una acción incorrecta

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

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

Posibles respuestas en el campo "message":

NO_ID_RENT - sin identificación de alquiler

RENT_DIE - el contrato de arrendamiento no se puede extender porque el número ha expirado

INVALID_PHONE - ID de arrendamiento no válido

WRONG_OPERATOR - arrendamiento transferido operador no MTT

SQL_ERROR - error del servidor SQL

API de Java

Inicio de obra

Incluir la biblioteca en maven

<dependecy>
  <groupId>ru.sms-activate</groupId>
  <artifactId>SMSActivateApi</artifactId>
  <version>1.0</version>
</dependecy>

Пример оформления вы можете посмотреть по ссылке на MavenRepository

Importe la clase principal para interactuar con la API de activación de sms.

import ru.sms_activate.SMSActivateApi;

Для использования библитеки вам необходим API ключ, его можно получить на данной странице и по ссылке ниже.

SMS-Activate API-Key

Un ejemplo de trabajo con equilibrio

Для получения текущего баланса на вашем аккаунте используйте метод getBalance. Если вас интересует помимо баланса кэшбэк, то вызовите метод getBalanceAndCashBack.


Метод getBalanceAndCashBack возращает объект класса SMSActivateGetBalanceAndCashBack.

getBalance: obtenga el saldo actual de la cuenta

Parámetros aceptados:отсутствуют

Tipo de pago

BigDecimal

getBalanceAndCashBack: obtenga el saldo y la suma de reembolso como saldo total

Parámetros aceptados:отсутствуют

Tipo de pago

SMSActivateGetBalanceAndCashBack

Obtenga el número usando el método getNumber

Parámetros aceptados:

countryId(Integer) - Identificador de país.

service(String) - Nombre corto del servicio.

forward*(boolean) - Necesito solicitar un número redirigido

operatorSet*(Set) - Un conjunto de operadores.

phoneException*(Set) - Prefijos exclusivos solo para Rusia, un conjunto de números del 3 al 6 (7918.7900111).

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

Tipo de pago

SMSActivateActivation

Obtenga información sobre los servicios disponibles

Parámetros aceptados:

countryId(Integer) - Identificador de país.

operatorSet(Set) - Conjunto de operadores que están disponibles para el servicio.

Tipo de pago

SMSActivateGetNumbersStatus

Obtenga servicio adicional para un número con reenvío

Parámetros aceptados:

activationId(Integer) - ID de activación.

service(String) - Nombre corto del servicio.

Tipo de pago

SMSActivateGetNumbersStatus

* En lugar de un identificador de activación, puede pasar el SMSActivateActivation recibido después de usar el método getNumber , o una de las activaciones después de usar getMultiServiceNumber .

getMultiServiceNumber: obtenga la activación para múltiples servicios

Parámetros aceptados:

countryId(Integer) - Identificador de país.

serviceMap(Set) - El conjunto de servicios para los que se compra la activación.

multiForwardList(List) - Lista de servicios con reenvío.

operatorSet(Set) - Un conjunto de operadores.

Tipo de pago

SMSActivateGetMultiServiceNumberResponse

Obtenga una lista completa de precios de activación

Parámetros aceptados:Отсутствуют

Tipo de pago

SMSActivateGetPriceInfo

getPricesByCountryIdAndServiceShortName: obtenga una lista de precios de activación por país y servicio

Parámetros aceptados:

countryId(Integer) - Identificador de país.

serviceShortName(String) - Nombre corto del servicio

Tipo de pago

SMSActivateGetPriceInfo

getPricesAllServicesByCountryId: obtenga una lista de precios de activación por país

Parámetros aceptados:

countryId(Integer) - Identificador de país.

Tipo de pago

SMSActivateGetPriceInfo

getPricesAllServicesByCountryId: obtenga una lista de precios para activaciones por servicio

Parámetros aceptados:

serviceShortName(String) - Nombre corto del servicio

Tipo de pago

SMSActivateGetPriceInfo

Obtener estado de activación por id

Parámetros aceptados:

activationId(Integer) - ID de activación.

Tipo de pago

SMSActivateGetStatusResponse

* En lugar de un identificador de activación, puede pasar el SMSActivateActivation recibido después de usar el método getNumber , o una de las activaciones después de usar getMultiServiceNumber .

setStatus: establece el estado de activación

Parámetros aceptados:

activationId(Integer) - ID de activación.

status(SMSActivateClientStatus) - El estado para configurar la activación

Tipo de pago

SMSActivateSetStatusResponse

* En lugar de un identificador de activación, puede pasar el SMSActivateActivation recibido después de usar el método getNumber , o una de las activaciones después de usar getMultiServiceNumber .

Algoritmo para recibir el texto completo de SMS con activación

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)
MESSAGE_WAS_SENT - Notifica que se ha enviado un SMS (Obligatorio para recibir el texto completo del sms)

Después de la configuración obligatoria del estado MESSAGE_WAS_SENT, configure la variable para recibir SMS utilizando el método waitSMS con los parámetros de activación y el tiempo de espera para el SMS.
Después de recibir el SMS, puede obtenerlo usando el método getFullSMS y luego mostrar el texto completo usando el método getText ()
Después de eso, puede configurar las activaciones en los siguientes estados:

CANCELAR - Cancelar activación
Inmediatamente después de recibir el código:
REQUEST_ONE_MORE_CODE - Solicita otro SMS
FINALIZAR - Confirmar el código SMS y completar la activación
Para activar con el estado REQUEST_ONE_MORE_CODE:
FINALIZAR - Confirmar el código SMS y completar la activación

getCountries: obtenga información del país

Parámetros aceptados:Отсутствуют

Tipo de pago

SMSActivateGetCountriesResponse

getQiwiRequisites: obtenga información sobre los requisitos de Qiwi

Parámetros aceptados:Отсутствуют

Tipo de pago

SMSActivateGetQiwiRequisitesResponse

getFullSms: obtiene el texto completo de sms desde el número

Parámetros aceptados:

activationId(Integer) - ID de activación.

Tipo de pago

SMSActivateGetFullSmsResponse

* En lugar de un identificador de activación, puede pasar el SMSActivateActivation recibido después de usar el método getNumber , o una de las activaciones después de usar getMultiServiceNumber .

getRentNumber: obtenga un número de alquiler

Parámetros aceptados:

countryId(Integer) - Identificador de país.

service(String) - Nombre corto del servicio

hours(Integer)* - Tiempo de alquiler.

operator(String)* - El nombre del operador de telefonía móvil.

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

Tipo de pago

SMSActivateRentActivation

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

GetRentServicesAndCountriesRun: obtenga servicios y países para alquilar

Parámetros aceptados:

countryId(Integer) - Identificador de país.

operatorSet(Set) - Conjunto de operadores celulares

hours(Integer)* - tiempo de alquiler

Tipo de pago

SMSActivateGetRentServicesAndCountriesResponse

GetRentStatusJava: obtener el estado de alquiler

Parámetros aceptados:

rentId(Integer) - El identificador del número alquilado.

Tipo de pago

SMSActivateRentStatus

* En lugar de rentId, puede pasar el objeto recibido de la SMSActivateRentActivation después de usar el método getRentNumber

Для большего числа примеров воспользуйтесь документацией на GitHub

                    <?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)
$number = $sms->getMultiServiceNumber('ok,vk,vi,av','0,0,0,1', 0, 'tele2');//Obtenga un número para los servicios Odnoklassniki, Vkontakte, Viber sin desvío de llamadas y Avito con desvío de llamadas foreach ($number as $value) { echo "Activación № " . $value['activation']. "para servicio ". $value['service'] ."\n"; }
echo "Número " . $value['phone'] ."\n";//Muestre la identificación y el número de activación
$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']; $getRentList = $sms->getRentList();//Obtenga una lista de las habitaciones alquiladas actualmente if (getRentList['status'] == 'success') foreach( $getRentList['values'] as $value) { echo " ID " . $value["id"] . " Número " . $value["phone"] ."\n"; }//Operadores de listas else echo "Código de error : " . $getRentList['message'];
                    
                        <--Скоро-->
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        
                        


                        
                        
                        
                        
                        
                        

                    
                
                    
                        
                            import ru.sms_activate.SMSActivateApi;//Inclusión de una clase en un proyecto.
SMSActivateApi smsActivateApi = new SMSActivate("API_KEY");//Cree una instancia de la clase SMSActivate
BigDecimal balance = smsActivateApi.getBalance();//Obtenga el saldo actual de la cuenta System.out.println("Balance: "+ balance)//Retirar el saldo recibido SMSActivateGetBalanceAndCashbackResponse smsActivateGetBalanceAndCashbackResponse = smsActivateApi.getBalanceAndCashback();//Obtenga saldo actual y reembolso System.out.println("Cashback + balance: "+ smsActivateGetBalanceAndCashbackResponse.getBalanceAndCashback());//Retirar la cantidad de saldo y reembolso SMSActivateActivation activation=smsActivateApi.getNumber(0,"vk")//Obtenga la activación para el servicio Vkontakte en Rusia System.out.println(activation);//Retirar la activación recibida SMSActivateGetNumbersStatusResponse smsActivateGetNumbersStatusResponse= smsActivateApi.getNumberStatus(0,null);//Obtenga información sobre los servicios disponibles
SMSActivateServiceInfo go = smsActivateGetNumbersStatusResponse.getSMSActivateServiceInfoByShortName("go");//Obtener información sobre números para el servicio de Google
System.out.println("Short name service: " + go.getShortName();//Devuelve el nombre corto del servicio. System.out.println("count phone numbers: "+ go.getCountPhoneNumber();//Devuelve el número de números de teléfono disponibles para activación. System.out.println(""Forwarding is available: "+ go.isForward() ? "yes" : "no"//Descubra si el servicio tiene un redireccionamiento
SMSActivateActivation activation=smsActivateApi.getNumbersStatus(0,"ot",true);//Activaciones
smsActivateApi.setStatus(activation, SMSActivateClientStatus.MESSAGE_WAS_SENT);//Configuración del estado MESSAGE_WAS_SENT después de enviar SMS para el número
SMSActivateActivation childActivation =smsActivateApi.getAdditionalService(activation,"av");//Solicitar una nueva activación para un servicio adicional
System.out.println(childActivation);//Visualización de información sobre activación adicional
Set<String>operatorSet= new HashSet<>(); operatorSet.add("mts");//Agregar un operador MTS al conjunto de operadores Map<String,Boolean>serviceMap= new HashMap<>(); serviceMap.put("av",false);//Agregar el servicio Avito a la lista de servicios (especifique verdadero si necesita un servicio con redirección)
SMSActivateGetMultiServiceNumberResponse multiServiceNumberResponse=smsActivateApi.getMultiServiceNumber(0, serviceMap, operatorSet);//Obtener activación para múltiples servicios
multiServiceNumberResponse.getSMSActivateActivationList().forEach(activation->{ System.out.println("Id: " + activation.getId()); System.out.println("Number: " + activation.getNumber()); System.out.println("Service name: " + activation.getShortName()); } //Visualización de información sobre activaciones recibidas
SMSActivateGetPricesResponse smsActivateGetPricesResponse=smsActivateApi.getPricesByCountryIdAndServiceShortName(0, "vk");//Obtención de una lista de precios para Rusia en el servicio Vkontakte. Para obtener una lista completa de precios, utilice el método getAllPrices ();
SMSActivateGetPriceInfo vk=smsActivateGetPricesResponse.getPriceInfo(0, "vk");//Obtener información sobre el servicio Vkontakte para Rusia
System.out.println(">>> Cost: "+ vk.getCost());//Obtenga el precio real del servicio. System.out.println(">>> count phone numbers: " + vk.getCountPhoneNumbers());//Devuelve el número de números de teléfono disponibles para activación.
SMSActivateActivation activation=smsActivateApi.getNumber(0,"vk")//Obtenga la activación para el servicio Vkontakte en Rusia System.out.println(activation);//Retirar la activación recibida SMSActivateGetStatusResponse getResponse = smsActivateApi.getStatus(activation);//Obtener un estado para la activación
System.out.println(getResponse.getSMSActivateGetStatus());//Visualización de información sobre el estado de activación
smsActivateApi.setStatus(activation, SMSActivateClientStatus.MESSAGE_WAS_SENT);//Configuración del estado MESSAGE_WAS_SENT después de recibir SMS para el número
smsActivateApi.setStatus(activation, SMSActivateClientStatus.FINISH);//Configuración del estado FINALIZAR después de recibir SMS para el número
SMSActivateGetCountriesResponse smsActivateGetCountriesResponse =smsActivateApi.getCountries();//Obtener una lista de países con información SMSActivateCountryInfo countryInfo = smsActivateGetCountriesResponse.get(0)//Obtener información sobre el primer país de la lista
System.out.println("Russian name: "+countryInfo.getRussianName();//Muestra el nombre ruso del país. System.out.println("English name: "+countryInfo.getEnglishName();//Muestra el nombre ruso del país. System.out.println("Support multi-service: "+ countryInfo.isSupportMultiService() ? "yes" : "no"//Mostrar si el país admite servicios múltiples
SMSActivateGetQiwiRequisitesResponse smsActivateGetQiwiRequisitesResponse=smsActivateApi.getQiwiRequisites();//Obtener información sobre Qiwi System.out.println("Comment: "+smsActivateGetQiwiRequisitesResponse.getComment()//Visualización de un comentario a los detalles System.out.println("Wallet: "+smsActivateGetQiwiRequisitesResponse.getWallet());//Retiro de billetera System.out.println("Up to date: "+smsActivateGetQiwiRequisitesResponse.getUpToDate());//Solicitud de retirada está declinada SMSActivateActivation activation=smsActivateApi.getNumber(0,"vk")//Obtenga la activación para el servicio Vkontakte en Rusia smsActivateApi.setStatus(activation, SMSActivateClientStatus.MESSAGE_WAS_SENT);//Configuración del estado MESSAGE_WAS_SENT después de enviar SMS para el número String code=smsActivateApi.waitSms(activation,2)//Configurar la recepción de sms en 2 minutos if(code == null) { smsActivateApi.setStatus(activation, SMSActivateClientStatus.CANCEL);//Configuración del estado de CANCELAR si no ha llegado el SMS }
else{
SMSActivateGetFullSmsResponse smsActivateGetFullSmsResponse=smsActivateApi.getFullSms(activation)//Recibir texto sms System.out.println("Full SMS: "+smsActivateGetFullSmsResponse.getText());//El retiro de los fondos }
SMSActivateRentActivation rentActivation= smsActivateApi.getRentNumber(0, "vk", 6);//Conseguir una habitación con alquiler System.out.println(">> ID: "+rentActivation.getId());//Retiro de identificación de activación System.out.println(">> Number: "+rentActivation.getId());//Solicitud de retirada está declinada System.out.println(">> End date: "+rentActivation.getId());//Visualización de la fecha de vencimiento de la activación SMSActivateGetRentServicesAndCountriesResponse smsActivateGetRentServicesAndCountriesResponse= smsActivateApi.getRentServicesAndCountries(0, null, 4);//Obtener información sobre servicios y países que admiten el alquiler.
smsActivateGetRentServicesAndCountriesResponse.getAllRentServices().forEach((serviceShortName, smsActivateRentService)->{ System.out.println("Service shortname: " + serviceShortName);
System.out.println(" count phone numbers: " + smsActivateRentService.getCountPhoneNumbers());
System.out.println(">> Cost: " + smsActivateRentService.getCost()); }
//Visualización de información sobre los servicios recibidos
SMSActivateRentActivation rentActivation= smsActivateApi.getRentNumber(0, "vk");//Conseguir una habitación con alquiler SMSActivateGetRentStatusResponse smsActivateGetRentStatusResponse= smsActivateApi.getRentStatus(rentActivation);//Obtener el estado de activación System.out.println(">> Count sms: "+ smsActivateGetRentStatusResponse.getCountSms());//Visualización del número de sms en el número alquilado