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

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

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

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

Нет номеров!

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

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

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

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

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

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

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

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

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