Application Programming Interface (API)

API KVAKVA-SMS.COM

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

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

URL параметры

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

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

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

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

Нет номеров!

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

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

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

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

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

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

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

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

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