[ GUIDE ] Working with the Virtual Number Services API

Всем привет!
Сегодня я покажу вам как использовать апи смс сервисов.
Программная платформа - Node.js
На примере буду использовать API сервиса - http://smsvk.net/
​

С чего начать?

Для начала нужно скачать Node.js .
Для этого переходим на сайт разработчика - https://nodejs.org/
Скачиваю стабильную версию (На данный момент 14.16.1 LTS)

Скриншот

Скачиваем редактор кода, я советую использовать visual studio code

Лучшие редакторы кода

О лучших редакторах кода можно почитать здесь - https://telegra.ph/Luchshie-redaktory-koda-i-IDE-dlya-JavaScript-razrabotchikov-04-24

Приступим к разработке

Этап №1

Создам папку и в ней 2 файла:
index (расширение файла .js)
config (расширение файла .json)
Открываем папку в редакторе кода.

Этап №2

Открываем файл config.json
Вставляемкод:

{
"key": "ключ для работы с апи",
"url": "http://smsvk.net/stubs/handler_api.php"
}

Code

{

    "key": "ключ для работы с апи",

    "url": "http://smsvk.net/stubs/handler_api.php"

}

Скриншот

Должно получиться так:

Этап №3

Открываем файл index.js
Вставляем код:

const API = require('sms-services-api').API;
const config = require('./config.json');

const api = new API(config.url, {
key: config.key
});

const start = async() => {
// здесь будем писать наш код
}

start();

Code

const API = require('sms-services-api').API;

const config = require('./config.json');



const api = new API(config.url, {

    key: config.key

});



const start = async() => {

    // здесь будем писать наш код

}



start();

Работа с апи

Баланс

const getBalance = await api.getBalance()
console.log(getBalance)

Code

const getBalance = await api.getBalance()

console.log(getBalance)

Скриншот

Ответ:
ACCESS_BALANCE: Ваш баланс

Количества доступных номеров

const getNumbersStatus = await api.getNumbersStatus()
console.log(JSON.parse(getNumbersStatus))

Code

const getNumbersStatus = await api.getNumbersStatus()

console.log(JSON.parse(getNumbersStatus))

Скриншот

Ответ

Ответ от сервиса в формтае названиеСервиса_0: кол-во номеров

Запрос на получение номера

Там где vk - вы можете заменить на тот сервис который вам нужно.

const getNumber = await api.getNumber('vk')
console.log(getNumber)

Code

const getNumber = await api.getNumber('vk')

console.log(getNumber)

Ответ

NO_NUMBERS - нет номеров
NO_BALANCE - закончился баланс
ACCESS_NUMBER:id:number - номер выдан
id нужен для дальнейшей работы с номером
number я думаю понятно что это номер телефона

Смена статуса номера

1 - сообщить о готовности номера (необязательно)
3 - запроситьповторный код для этой активации
6 - завершить активацию(если был статус "код получен" - помечает успешно и завершает, если был "подготовка" - удаляет и помечает ошибка, если был статус "ожидает повтора" - переводит активацию в ожидание смс)
8 - сообщить о том, что номер использован и отменить активацию

const setStatus = await api.setStatus(status, id)
console.log(setStatus)

Code

const setStatus = await api.setStatus(status, id)

console.log(setStatus)

status - заменяем на тот статус который вам нужно указать
id - заменяем на айди активации

Ответ

ACCESS_READY - готовность номера подтверждена
ACCESS_RETRY_GET - ожидание нового смс
ACCESS_ACTIVATION - сервис успешно активирован
ACCESS_CANCEL - активация отменена

Получение состояния активации

const getStatus = await api.getStatus(id)
console.log(getStatus)

Code

const getStatus = await api.getStatus(id)

console.log(getStatus)

id - заменяем на айди активации

Этап №4

Открываем терминал:
Нажимаем сочетание клавиш « CTRL + SHIFT + ` »

Этап №5

Для установки библиотеки sms-services-api (С помощью нее мы работаем с апи смс сервисов)
Пишем в терминале npm i sms-services-api

Нажимаем ENTER

Этап №6

Для запуска вам нужно написать в терминале node index
Если запуск прошел успешно при запросе в терминал вы увидите ответ от сервиса смс активаций

Что-то интересное

Возможно тема баян - возможно нет, это решать только вам!
Библиотека работаем не со всеми сервисами, а только с тема у которых одинаковые запросы как здесь - http://smsvk.net/api.html

По возможности я буду обновлять библиотеку и добавлять работу как можно с большим кол-вом сервисов.
Все выше показано как пример - использовать можете как хотите.

Всем спасибо за внимание!
​