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

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

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

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

Нет номеров!

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

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

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

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

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

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

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

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

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