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}
Магнит mg
Перекресток pk
Глобус gb
OLX ox
Spar sr
WebMoney wm
Bitforex bf
Blockchain bc
Newnext nn
Mercuryo my
AOL ao
ВСК страхование vs
GO!WALLET gw
Tiktok tt
Curve cv
WhatsApp wa
localbitcoins lb
Tabor tb
Яндекс ya
PayPal pp
iost it
Pocopay py
Protonmail pm
Star-clicks sc
Viber vi
Rambler rm
Grailed gr
BBM bm
GrabTaxi ti
Верный vn
Пятерочка pt
HQ Trivia hq
bunq bq
Livescure ls
Burger King bk
Mojeid cz mj
Wire wr
Сити мобил si
Ozon oz
Google gl
Telegram tg
Electroneum en
LinkedIn ln
Premium one ta
AirBnb ab
Amazon am
Mamba mb
Okey oy
Верный Игра vg
LogicVapes lv
Бахетле bt
Яндекс.Такси yt
1cupis cs
Такси Максим txm
Moteplassen mp
AutoRu ar
Виктория vt
Yahoo yh
BitTube bt
Facebook fb
FriendsClub fc
Line messenger lm
Instagram ig
Suomi24 Fi so
Wirex wx
Blablacar bb
ДругВокруг dv
KeyBase kb
Plenty Of Fish pf
DrugVokrug dv
MostBet mo
Monese me
Twitter tw
Steam st
Payoneer po
Badoo bd
Drom dr
Michat mc
Aliexpress ai
Казино Online ko
inDriver id
Cofix cx
youdo yd
Paysera ps
Change Wallet cw
Nimses ns
Мираторг mt
Openpoint op
Uber ub
Dent dt
Jaxx jx
Yandex ya
Лента lt
Горздрав gz
Atlas at
KakaoTalk kt
Weku wk
Monzo mo
Вкусвил vv
Tantan tt
Bumble bu
Fiverr fr
Avito av
Магнолия mn
Карусель ks
Douyin dn
ChatSecure cs
Epic Games eg
Ebay eb
WeChat wc
LHV Bank lh
Coop Pank ck
Microsoft ms
такси Минимум tm
ПочтаБанк pb
SeoSprint ss
VK & MailRu Group mr
MeetMe mm
Tencent QQ qq
Revolut rl
G2G gg
Payrue pr
Gusli gu
QIWl Wallet qw
Skrill sl
Sipnet sn
Paysend pd
Hezzl hl
Beget bg
mts cashback cm
OraleCloud oc
C.Pay cp
Discord dc
N26 n2
Rediffmail rf
GettTaxi gt
Naver nv
Autoins as
iCard ic
Bolt bo
Tinder td
JD jd
Allegro.pl ap
Название страны Код {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
Spain es yoigo
United Kingdom gb vodafone
three
France fr lycamobile
lebara
GET https://vak-sms.ru/api/getCountNumber/?apiKey={apiKey}&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/?apiKey={apiKey}&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}
Магнит mg
Перекресток pk
Глобус gb
OLX ox
Spar sr
WebMoney wm
Bitforex bf
Blockchain bc
Newnext nn
Mercuryo my
AOL ao
ВСК страхование vs
GO!WALLET gw
Tiktok tt
Curve cv
WhatsApp wa
localbitcoins lb
Tabor tb
Яндекс ya
PayPal pp
iost it
Pocopay py
Protonmail pm
Star-clicks sc
Viber vi
Rambler rm
Grailed gr
BBM bm
GrabTaxi ti
Верный vn
Пятерочка pt
HQ Trivia hq
bunq bq
Livescure ls
Burger King bk
Mojeid cz mj
Wire wr
Сити мобил si
Ozon oz
Google gl
Telegram tg
Electroneum en
LinkedIn ln
Premium one ta
AirBnb ab
Amazon am
Mamba mb
Okey oy
Верный Игра vg
LogicVapes lv
Бахетле bt
Яндекс.Такси yt
1cupis cs
Такси Максим txm
Moteplassen mp
AutoRu ar
Виктория vt
Yahoo yh
BitTube bt
Facebook fb
FriendsClub fc
Line messenger lm
Instagram ig
Suomi24 Fi so
Wirex wx
Blablacar bb
ДругВокруг dv
KeyBase kb
Plenty Of Fish pf
DrugVokrug dv
MostBet mo
Monese me
Twitter tw
Steam st
Payoneer po
Badoo bd
Drom dr
Michat mc
Aliexpress ai
Казино Online ko
inDriver id
Cofix cx
youdo yd
Paysera ps
Change Wallet cw
Nimses ns
Мираторг mt
Openpoint op
Uber ub
Dent dt
Jaxx jx
Yandex ya
Лента lt
Горздрав gz
Atlas at
KakaoTalk kt
Weku wk
Monzo mo
Вкусвил vv
Tantan tt
Bumble bu
Fiverr fr
Avito av
Магнолия mn
Карусель ks
Douyin dn
ChatSecure cs
Epic Games eg
Ebay eb
WeChat wc
LHV Bank lh
Coop Pank ck
Microsoft ms
такси Минимум tm
ПочтаБанк pb
SeoSprint ss
VK & MailRu Group mr
MeetMe mm
Tencent QQ qq
Revolut rl
G2G gg
Payrue pr
Gusli gu
QIWl Wallet qw
Skrill sl
Sipnet sn
Paysend pd
Hezzl hl
Beget bg
mts cashback cm
OraleCloud oc
C.Pay cp
Discord dc
N26 n2
Rediffmail rf
GettTaxi gt
Naver nv
Autoins as
iCard ic
Bolt bo
Tinder td
JD jd
Allegro.pl ap
Название страны Код {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
Spain es yoigo
United Kingdom gb vodafone
three
France fr lycamobile
lebara
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"}  # Отправлены неверные данные.
Недостаточно средств!

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

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

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

Нет номеров!

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

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

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

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

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

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

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

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

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