Application Programming Interface (API)

API VAK-SMS.RU

Все запросы отправляются с помощью GET-запроса на адрес https://vak-sms.ru
В каждом запросе должен содержаться API ключ, узнать его можно в настройках аккаунта.
Ваш apiKey:

Баланс пользователя, в рублях

URL параметры

Параметр Тип Описание
apiKey string Обязательный API ключ доступа
GET https://vak-sms.ru/api/getBalance/?apiKey={apiKey} HTTP/1.1
Приведенная выше команда возвращает JSON, структурированный так:
{"balance": 100.0}

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

URL параметры

Параметр Тип Описание
service string Обязательный Код сайта, сервиса, соц. сети
country string Default = ru Код страны номера телефона
operator string Default = None Код сайта, сервиса, соц. сети
price string Default = None Цена за номер
Название сайта Код {service}
Paysend pd
Юла + переадр. yl_1
LinkedIn ln
Amazon am
Spar sr
Suomi24 Fi so
Nimses ns
Moteplassen mp
SeoSprint ss
Вкусвил vv
ICQ iq
Mamba mb
Bolt bo
Star-clicks sc
Microsoft ms
Fiverr fr
Monzo mo
OraleCloud oc
Перекресток pk
Discord dc
iCard ic
Ozon oz
GrabTaxi ti
такси Минимум tm
Rediffmail rf
Mojeid cz mj
VKcom vk
OLX ox
Burger King bk
Beget bg
Blockchain bc
iost it
Steam st
AutoRu ar
Line messenger lm
Юла yl
Ebay eb
Payoneer po
Instagram ig
Tabor tb
Atlas at
Avito + переадр. av_1
Бахетле bt
Dent dt
BBM bm
KakaoTalk kt
Blablacar bb
Electroneum en
Google gl
Change Wallet cw
Виктория vt
LHV Bank lh
HQ Trivia hq
Tencent QQ qq
Viber vi
Naver nv
Payrue pr
Paysera ps
Drom dr
Premium one ta
Badoo bd
Карусель ks
Сити мобил si
MeetMe mm
Wirex wx
Revolut rl
Sipnet sn
Facebook fb
QIWl Wallet qw
WeChat wc
Twitter tw
ПочтаБанк pb
GO!WALLET gw
Казино Online ko
GettTaxi gt
AOL ao
Aliexpress ai
Пятерочка pt
JD jd
Curve cv
Yahoo yh
Monese me
Яндекс.Такси yt
N26 n2
Plenty Of Fish pf
Skrill sl
DrugVokrug dv
Weku wk
Mercuryo my
Newnext nn
OKru ok
Jaxx jx
Pocopay py
1cupis cs
Магнолия mn
Wire wr
Горздрав gz
Tantan tt
Мираторг mt
Tiktok tt
Tinder td
Telegram tg
Cofix cx
Okey oy
MailRu ml
Yandex ya
C.Pay cp
Yalla ll
Autoins as
Epic Games eg
Магнит mg
Coop Pank ck
Верный vn
Openpoint op
WhatsApp wa
DeliveryClub db
Hezzl hl
AirBnb ab
Глобус gb
Яндекс ya
youdo yd
Uber ub
Pof.com pc
Livescure ls
MostBet mo
Avito av
Rambler rm
Protonmail pm
FriendsClub fc
PayPal pp
ДругВокруг dv
Bitforex bf
Michat mc
WebMoney wm
ChatSecure cs
BitTube bt
Название страны Код {country} Имя {operator}
Russia ru mts
beeline
megafon
rostelecom
tele2
Kazakhstan kz tele2
activ
altel
beeline
Finland fi dna
elisa
Netherlands nl lebara
Sweden se telenor
comviq
lycamobile
Estonia ee tele2
elisa
telia
Lithuania lt tele2
Latvia lv tele2
lmt
GET https://vak-sms.ru/api/getCountNumber/?service={service}&country={country}&operator={operator}&price HTTP/1.1
Приведенная выше команда возвращает JSON, структурированный так:
{"{SERVICE}": 332}  # В SERVICE содержится переданный код
Приведенная выше команда с параметром price возвращает JSON, структурированный так:
{"{SERVICE}": 332, "price": 2.0}   # В SERVICE содержится переданный код, в PRICE содержится цена

GET https://vak-sms.ru/api/getCountNumberList/?country={country}&operator={operator} HTTP/1.1
Приведенная выше команда возвращает JSON, структурированный так:
{"vk": {"code": "vk", "count": 403, "price": 20.0}, "ok": {"code": "ok", "count": 403, "price": 3.0}, "ig": {"code": "ig", "count": 403, "price": 3}}

Получение номера

URL параметры

Параметр Тип Описание
apiKey string Обязательный API ключ доступа
service string Обязательный Код сайта, сервиса, соц. сети
country string Default = ru Код страна номера телефона
operator string Default = None Код сайта, сервиса, соц. сети, приложения
softId int Default = None Номер софта для получения отчислений по реферальной системе для разработчиков
Название сайта Код {service}
Paysend pd
Юла + переадр. yl_1
LinkedIn ln
Amazon am
Spar sr
Suomi24 Fi so
Nimses ns
Moteplassen mp
SeoSprint ss
Вкусвил vv
ICQ iq
Mamba mb
Bolt bo
Star-clicks sc
Microsoft ms
Fiverr fr
Monzo mo
OraleCloud oc
Перекресток pk
Discord dc
iCard ic
Ozon oz
GrabTaxi ti
такси Минимум tm
Rediffmail rf
Mojeid cz mj
VKcom vk
OLX ox
Burger King bk
Beget bg
Blockchain bc
iost it
Steam st
AutoRu ar
Line messenger lm
Юла yl
Ebay eb
Payoneer po
Instagram ig
Tabor tb
Atlas at
Avito + переадр. av_1
Бахетле bt
Dent dt
BBM bm
KakaoTalk kt
Blablacar bb
Electroneum en
Google gl
Change Wallet cw
Виктория vt
LHV Bank lh
HQ Trivia hq
Tencent QQ qq
Viber vi
Naver nv
Payrue pr
Paysera ps
Drom dr
Premium one ta
Badoo bd
Карусель ks
Сити мобил si
MeetMe mm
Wirex wx
Revolut rl
Sipnet sn
Facebook fb
QIWl Wallet qw
WeChat wc
Twitter tw
ПочтаБанк pb
GO!WALLET gw
Казино Online ko
GettTaxi gt
AOL ao
Aliexpress ai
Пятерочка pt
JD jd
Curve cv
Yahoo yh
Monese me
Яндекс.Такси yt
N26 n2
Plenty Of Fish pf
Skrill sl
DrugVokrug dv
Weku wk
Mercuryo my
Newnext nn
OKru ok
Jaxx jx
Pocopay py
1cupis cs
Магнолия mn
Wire wr
Горздрав gz
Tantan tt
Мираторг mt
Tiktok tt
Tinder td
Telegram tg
Cofix cx
Okey oy
MailRu ml
Yandex ya
C.Pay cp
Yalla ll
Autoins as
Epic Games eg
Магнит mg
Coop Pank ck
Верный vn
Openpoint op
WhatsApp wa
DeliveryClub db
Hezzl hl
AirBnb ab
Глобус gb
Яндекс ya
youdo yd
Uber ub
Pof.com pc
Livescure ls
MostBet mo
Avito av
Rambler rm
Protonmail pm
FriendsClub fc
PayPal pp
ДругВокруг dv
Bitforex bf
Michat mc
WebMoney wm
ChatSecure cs
BitTube bt
Название страны Код {country} Имя {operator}
Russia ru mts
beeline
megafon
rostelecom
tele2
Kazakhstan kz tele2
activ
altel
beeline
Finland fi dna
elisa
Netherlands nl lebara
Sweden se telenor
comviq
lycamobile
Estonia ee tele2
elisa
telia
Lithuania lt tele2
Latvia lv tele2
lmt
GET https://vak-sms.ru/api/getNumber/?apiKey={apiKey}&service={service}&country={country}&operator={operator}&softId={softId} HTTP/1.1
Приведенная выше команда возвращает JSON, структурированный так:
{"tel": 79991112233, "idNum": "3adb61376b8f4adb90d6e758cf8084fd"}

Изменение статуса

URL параметры

Параметр Тип Описание
apiKey string Обязательный API ключ доступа
idNum string Обязательный ID операции
status string Обязательный
status=send
status=end
status=bad
Статус операции.
status=send - Еще смс
status=end - отмена номера
status=bad - номер уже использован, забанен

После получения номера, сразу происходит ожидание смс. Отправлять запрос с параметрами status=send необходимо только в случае получения еще одной смс с кодом. Если отправлена еще смс, необходимо повторить запрос с тем же idNum и status=send. Такое возможно в течение выделенного времени после получения номера телефона. Повторное получение смс БЕСПЛАТНО. В случае если пришел не верный код, необходимо повторно отправить запрос с тем же idNum и status=send что бы получить новую смс с другим кодом


GET https://vak-sms.ru/api/setStatus/?apiKey={apiKey}&status={status}&idNum={idNum} HTTP/1.1
Приведенная выше команда с параметром status=send(еще смс) возвращает JSON, структурированный так:
{"status": "ready"}
Приведенная выше команда с параметром status=end (отмена номера) возвращает один из вариантов JSON, структурированный так:
{"status": "end"}  # номер успешно отменен.
{"status": "smsReceived"}  # на данный номер уже получен код подтверждения, отмена невозможна.
{"status": "waitSMS"}  # на данные номер уже отправлено смс, отмена невозможна. Ожидайте код.
{"status": "update"}  # статус обновлен.
Приведенная выше команда с параметром status=bad (номер уже использован, забанен) возвращает один из вариантов JSON, структурированный так:
{"status": "update"}  # статус успешно обновлен
{"status": "waitSMS"}  # статус не может быть обновлен, т.к сервис ожидает повторную смс

Состояние активации

URL параметры

Параметр Тип Описание
apiKey string Обязательный API ключ доступа
idNum string Обязательный ID операции
all boolean Default = None Параметр указывает необходимость получить весь список полученных кодов
GET https://vak-sms.ru/api/getSmsCode/?apiKey={apiKey}&idNum={idNum}&all HTTP/1.1
Приведенная выше команда возвращает один из вариантов JSON, структурированный так:
{"smsCode": null}  # сервис ожидает СМС
{"smsCode": "CODE"}  # код получен, в переменной "CODE" содержится код подтверждения активации, type=str
Приведенная выше команда с параметром all возвращает JSON, структурированный так:
{"smsCode": ["CODE1", "CODE2"]}  # Список полученых кодов, type=list(str)



Варианты ошибок

{"error": "apiKeyNotFound"}  # Неверный API ключ.
{"error": "noService"}  # Данный сервис не поддерживается, свяжитесь с администрацией сайта.
{"error": "noNumber"}  # Нет номеров, попробуйте позже.
{"error": "noMoney"}  # Недостаточно средств, пополните баланс.
{"error": "noCountry"}  # Запрашиваемая страна отсутствует.
{"error": "noOperator"}  # Оператор не найдет для запрашиваемой страны.
{"error": "badStatus"}  # Не верный статус.
{"error": "idNumNotFound"}  # Не верный ID операции.
{"error": "badService"}  # Не верный код сайта, сервиса, соц. сети.
{"error": "badData"}  # Отправлены неверные данные.
Недостаточно средств!

У вас недостаточно средств на счету. Пополните свой счет, чтобы дальше пользоваться сервисом.

Сервис временно недоступен!

Пожалуйста, попробуйте позже или напишите нам!

Нет номеров!

В данный момент для данного сервиса нет номеров!

Отмена невозможна!

Отмена данного номера в данный момент невозможна!

Продление невозможно!

Продление данного номера в данный момент невозможно!

Изменение невозможно!

Изменение данного комментария невозможно!

Неорректное значение!

Введите корректное значение суммы к оплате!