API documentation
API is a Protocol of interaction between your SOFTWARE and our activation server.
The API is needed in order to automate the process of receiving SMS messages on your side All requests (supported by POST and GET) should go to
https://sms-service-online.com/stubs/handler_apiAttention
All requests must have API key-parameter "api_key", localization for interaction with ruble / dollar (ru/en) balance-parameter "lang", method name-parameter "action".
API key You can get in the section:Profile.
getBalance
To check the balance
https://sms-service-online.com/stubs/handler_api?api_key=APIKEY&action=getBalance&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
action
string
Method name
lang
string
Localization ru or en
Server response:
Пример ответа:
463.02
getCountryAndOperators
Get all countries and operators available to them
https://sms-service-online.com/stubs/handler_api?api_key=APIKEY&action=getCountryAndOperators&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
lang
string
Localization ru or en
Server response:
Пример ответа в JSON:
[{"id":0,"name":"Россия","operators":{"any":"any","tele2":"tele2","tinkoff":"tinkoff","ttk":"ttk","yota":"yota"}},{"id":1,"name":"Украина","operators":{"any":"any","kyivstar":"kyivstar","life":"life","lycamobile":"lycamobile","mts":"mts","utel":"utel","vodafone":"vodafone"}}]
Field
Example
Description
id
0
ID страны
name
Россия
Название страны
operators
["operators":{"aiva":"aiva", "any":"any"}]
Массив с ID операторов
getServicesAndCost
Get current prices and number of rooms
https://sms-service-online.com/stubs/handler_api?api_key=APIKEY&action=getServicesAndCost&country=COUNTRY&operator=OPERATOR&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
lang
string
Localization ru or en
Server response:
Пример ответа в JSON:
[{"id":"vk","name":"Вконтакте","price":29.88,"quantity":"19"},{"id":"ok","name":"Ok.ru","price":1.34,"quantity":"2776"},{"id":"wa","name":"Whatsapp","price":0,"quantity":"0"}]
Field
Example
Description
id
vk
ID сервиса
name
Вконтакте
Название сервиса
price
29.88
Актуальная цена
quantity
19
Количество номеров
getNumber
Room booking
https://sms-service-online.com/stubs/handler_api?api_key=APIKEY&action=getNumber&service=SERVICE&operator=OPERATOR&country=COUNTRY&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
action
string
Method name
lang
string
Localization ru or en
Server response:
Server response
Example
Description
NO_BALANCE
NO_BALANCE
Недостаточно баланса на аккаунте API
NO_NUMBERS
NO_NUMBERS
Нет номеров с заданными параметрами, попробуйте позже, или поменяйте оператора, страну.
ACCESS_NUMBER:ID:NUMBER
ACCESS_NUMBER:234242:79991728822
Получили номер, ID активации - ID, сам номер с кодом страны - NUMBER
setStatus
To change the status
https://sms-service-online.com/stubs/handler_api?api_key=APIKEY&action=setStatus&id=ID&status=STATUS&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
action
string
Method name
id
integer
Activation ID received when requesting a number
status
integer
Status to be transferred to activation
lang
string
Localization ru or en
Available statuses:
3 - Запросить еще одну смс
6 - Завершить активацию
8 - Отменить заказ
Server response:
Server response
Description
NO_BALANCE
Недостаточно баланса на аккаунте API
ACCESS_CANCEL
Активация отменена
ACCESS_RETRY_GET
Ожидаем новое смс
ACCESS_ACTIVATION
Активация успешно завершена
getStatus
To obtain the current status
https://sms-service-online.com/stubs/handler_api?api_key=APIKEY&action=getStatus&id=ID&lang=LANGField
Type
Description
api_key
string
Your API key provides access to paid services. The API key should be kept secret
action
string
Method name
id
integer
Activation ID received when requesting a number
lang
string
Localization ru or en
Server response:
Server response
Description
STATUS_WAIT_CODE
Ожидаем прихода смс
STATUS_CANCEL
активация отменена
STATUS_OK:CODE
Код получен (где CODE - код активации)
Annex 1. List of countries
ID
Наименование
Доступные операторы
0
Russia
aiva, any, beeline, danycom, ezmobile, lycamobile, matrix, megafon, motiv, mts, rostelecom, sber, simsim, tele2, tinkoff, ttk, winmobile, yota,
1
Ukraine
3mob, any, kyivstar, life, lycamobile, mts, utel, vodafone,
2
Kazakhstan
activ, altel, any, beeline, tele2,
3
China
any, chinamobile, unicom,
5
Myanmar
any, telenor,
6
Indonesia
any, axis, telkomsel,
8
Kenya
airtel, any, telkom,
11
Kyrgyzstan
any, beeline, megacom, o!,
15
Poland
any, klucz, orange,
16
England
any, ee, lebara, lycamobile, o2, threeuk, tmobile,
19
Nigeria
airtel, any, etisalat, glomobile, mtn,
20
Macao
3macao, any,
21
Egypt
any, etisalat, orange, vodafone,
23
Ireland
any, lycamobile,
26
Haiti
any, natcom,
27
Ivory coast
any, moov, mtn, orange,
28
Gambia
africel, any, comium, gamcel, qcell,
29
Serbia
any, mobtel, mts, vip,
30
Yemen
any, mtn, sabafon,
32
Romania
any, digi, lycamobile, orange, telekom, vodafone,
34
Estonia
any, goodline,
35
Azerbaijan
any, azerfon,
38
Ghana
any, glomobile, millicom, mtn, vodafone,
40
Uzbekistan
any, mts, ucell, uzmobile,
42
Chad
airtel, any, salam, tigo,
43
Germany
any, lebara, o2,
44
Lithuania
any, telia,
45
Croatia
any,
46
Sweden
any, comviq, lycamobile, tele2,
47
Iraq
any, asiacell, korek,
48
Netherlands
any, lycamobile,
49
Latvia
any, tele2,
50
Austria
any,
51
Belarus
any, life, mdc, mts,
59
Slovenia
any,
63
Czech
any,
67
New Zealand
2degree, any, vodafone,
68
Guinea
any, cellcom, mtn, orange,
69
Mali
any, malitel, telecel,
72
Mongolia
any, beeline,
Annex 2. Service list
ID
Наименование
vk
VK.com
ok
Ok.ru
wa
vi
Viber
tg
Telegram
wb
go
av
Avito
fb
tw
ub
Uber
qw
Qiwi
gt
Gett
sn
OLX
ig
ss
Hezzl
ym
Youla.ru
ma
Mail.ru
mm
Microsoft
uk
Airbnb
me
Line msg
mb
Yahoo
we
DrugVokrug.ru
bd
5ka.ru
kp
HQ Trivia
dt
Delivery Club
ya
Yandex
mt
Steam
oi
Tinder
fd
Mamba
zz
Dent
kt
KakaoTalk
pm
AOL
tn
Tencent QQ
mg
Magnit
pf
pof.com
kl
kolesa.kz
po
premium.one
nv
Naver
nf
Netflix
iq
icq
ob
Onlinerby
kb
kufarby
im
Imo
mc
Michat
ds
Discord
vv
Seosprint
ji
Monobank
lf
Douyin
hu
Ukrnet
wg
Skout
rz
EasyPay
vf
Q12 Trivia
ny
Pyro Music
rr
Wolt
fe
CliQQ
la
ssoidnet
zh
Zoho
gp
Ticketmaster
am
Amazon
ly
Olacabs
tc
Rambler
dp
ProtonMail
pg
NRJ Music Awards
yf
Citymobil
op
MIRATORG
fx
PGbonus
qr
MEGA
yk
SportMaster
ls
Careem
bl
BIGO LIVE
mu
MyMusicTaste
fu
Snapchat
bf
Keybase
sg
OZON
uu
Wildberries
ua
BlaBlaCar
ab
Alibaba
iv
Inboxlv
zy
Nttgame
gd
Surveytime
fy
Mylove
ce
mosru
tl
Truecaller
hm
Globus
tx
Bolt
ka
Shopee
pl
Perekrestok
ip
Burger King
cm
Prom
hw
AliPay
de
Karusel
jc
IVI
rl
inDriver
df
Happn
ui
RuTube
up
Magnolia
nz
Foodpanda
kf
ri
BillMill
cc
Quipp
lr
Okta
za
JDcom
da
MTS CashBack
ug
Fiqsy
sq
KuCoinPlay
zr
Papara
xv
Wish
cx
Icrypex
cw
PaddyPower
li
Baidu
dz
Dominos Pizza
xz
paycell
rd
Lenta
qb
Payberry
hz
Drom
dh
eBay
ot
Not on the list
Possible error
Server response
Description
BAD_ACTION
Неправильное формирование запроса
BAD_KEY
Неверный API-ключ
BAD_LANG
Неверная локазация, приниматся ru или en
NO_ACTIVATION
ID активации не существует
ERROR_SQL
Ошибка базы SQL-сервера