Прием смс - Документация API

API - это протокол взаимодействия между вашим ПО и нашим сервером активаций.

API нужен для того, чтобы автоматизировать процесс получение смс сообщений на вашей стороне Все запросы (поддерживаются POST и GET) должны идти на

https://sms-service-online.com/stubs/handler_api

Внимание

Во всех запросах должен присутствовать API ключ - параметр "api_key", локализация для взаимодействия с рублевым/долларовым (ru/en) балансом - параметр "lang", название метода - параметр "action".

API ключ Вы можете получить в разделе:Профиль.

Поле

Тип

Описание

api_key

string

Ваш API-ключ, обеспечивает доступ к оплаченным услугам. API-ключ следует хранить в тайне

action

string

Название метода

lang

string

Локализация ru или en

Ответ сервера:

Пример ответа:

463.02

getCountryAndOperators

Получить все страны и операторов доступных для них

https://sms-service-online.com/stubs/handler_api?api_key=APIKEY&action=getCountryAndOperators&lang=LANG

Поле

Тип

Описание

api_key

string

Ваш API-ключ, обеспечивает доступ к оплаченным услугам. API-ключ следует хранить в тайне

lang

string

Локализация ru или en

Ответ сервера:

Пример ответа в 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"}}]

Поле

Пример

Описание

id

0

ID страны

name

Россия

Название страны

operators

["operators":{"aiva":"aiva", "any":"any"}]

Массив с ID операторов

getServicesAndCost

Получить актуальные цены и количество номеров

https://sms-service-online.com/stubs/handler_api?api_key=APIKEY&action=getServicesAndCost&country=COUNTRY&operator=OPERATOR&lang=LANG

Поле

Тип

Описание

api_key

string

Ваш API-ключ, обеспечивает доступ к оплаченным услугам. API-ключ следует хранить в тайне

operator

string

Сотовый оператор номер которого необходимо получить см. "Список стран"

country

integer

ID Страны номер которой необходимо получить см. "Список стран"

lang

string

Локализация ru или en

Ответ сервера:

Пример ответа в 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"}]

Поле

Пример

Описание

id

vk

ID сервиса

name

Вконтакте

Название сервиса

price

29.88

Актуальная цена

quantity

19

Количество номеров

Поле

Тип

Описание

api_key

string

Ваш API-ключ, обеспечивает доступ к оплаченным услугам. API-ключ следует хранить в тайне

action

string

Название метода

service

string

Сервис, номер для которого необходимо получить см. "Список сервисов"

operator

string

Сотовый оператор номер которого необходимо получить см. "Список стран"

country

integer

ID Страны номер которой необходимо получить см. "Список стран"

lang

string

Локализация ru или en

Ответ сервера:

Ответ сервера

Пример

Описание

NO_BALANCE

NO_BALANCE

Недостаточно баланса на аккаунте API

NO_NUMBERS

NO_NUMBERS

Нет номеров с заданными параметрами, попробуйте позже, или поменяйте оператора, страну.

ACCESS_NUMBER:ID:NUMBER

ACCESS_NUMBER:234242:79991728822

Получили номер, ID активации - ID, сам номер с кодом страны - NUMBER

Поле

Тип

Описание

api_key

string

Ваш API-ключ, обеспечивает доступ к оплаченным услугам. API-ключ следует хранить в тайне

action

string

Название метода

id

integer

ID активации, полученное при запросе номера

status

integer

Статус который необходимо передать активации

lang

string

Локализация ru или en

Доступные статусы:

3 - Запросить еще одну смс

6 - Завершить активацию

8 - Отменить заказ

Ответ сервера:

Ответ сервера

Описание

NO_BALANCE

Недостаточно баланса на аккаунте API

ACCESS_CANCEL

Активация отменена

ACCESS_RETRY_GET

Ожидаем новое смс

ACCESS_ACTIVATION

Активация успешно завершена

Поле

Тип

Описание

api_key

string

Ваш API-ключ, обеспечивает доступ к оплаченным услугам. API-ключ следует хранить в тайне

action

string

Название метода

id

integer

ID активации, полученное при запросе номера

lang

string

Локализация ru или en

Ответ сервера:

Ответ сервера

Описание

STATUS_WAIT_CODE

Ожидаем прихода смс

STATUS_CANCEL

активация отменена

STATUS_OK:CODE

Код получен (где CODE - код активации)

Приложение 1. Список стран

ID

Наименование

Доступные операторы

0

Россия

aiva, any, beeline, center2m, danycom, ezmobile, lycamobile, matrix, megafon, motiv, mts, mtt, mtt_virtual, rostelecom, sber, simsim, tele2, tinkoff, ttk, winmobile, yota,

1

Украина

3mob, any, intertelecom, kyivstar, life, lycamobile, mts, utel, vodafone,

2

Казахстан

activ, altel, any, beeline, kcell, tele2,

3

Китай

any, chinamobile, china_unicom, unicom,

16

Англия (UK)

any, cmlink, ee, ezmobile, lebara, lycamobile, o2, talk_telecom, three, tmobile, vectone, vodafone,

5

Мьянма

any, telenor,

6

Индонезия

any, axis, indosat, telkomsel, three,

7

Малайзия

any, celcom, digi, hotlink, u_mobile,

8

Кения

airtel, any, econet, orange, safaricom, telkom,

9

Танзания

any,

10

Вьетнам

any, itelecom, mobifone, vietnamobile, viettel, vinaphone,

11

Кыргызстан

any, beeline, megacom, o!,

12

США

any, cellular, tmobile,

13

Израиль

019mobile, any, golan_telecom, home_cellular, hot_mobile, jawwal, ooredoo, orange, pelephone, rami_levy,

14

Гонконг

any, chinamobile, csl_mobile, imc, three, unicom,

15

Польша

aero2, any, e_telko, klucz, lycamobile, netia, orange, play, plus, tmobile,

4

Филиппины

any, globe_telecom, smart, tm,

17

Мадагаскар

any,

18

Дем. Конго

africel, airtel, any, orange, vodacom,

19

Нигерия

airtel, any, etisalat, glomobile, mtn,

20

Макао

any,

21

Египет

any, etisalat, orange, vodafone,

22

Индия

any,

23

Ирландия

any, lycamobile,

24

Камбоджа

any,

25

Лаос

any, etl, telekom, tplus, unitel,

26

Гаити

any, natcom,

27

Кот д'Ивуар

any, moov, mtn, orange,

28

Гамбия

africel, any, comium, gamcel, qcell,

29

Сербия

any, mobtel, mts, vip,

30

Йемен

any, mtn, sabafon, yemen_mobile,

31

ЮАР

any, lycamobile, mtn, telkom, vodacom,

32

Румыния

any, digi, lycamobile, my_avon, orange, runex_telecom, telekom, vodafone,

33

Колумбия

any, claro,

34

Эстония

any, elisa, goodline, super, tele2, topconnect,

35

Азербайджан

any,

36

Канада (вирт.)

any, cellular, lucky, rogers,

37

Марокко

any, inwi, itissalat, orange,

38

Гана

airtel, any, glomobile, millicom, mtn, vodafone,

39

Аргентина

any,

40

Узбекистан

any, beeline, mts, ucell, uzmobile,

41

Камерун

any, mtn, nexttel, orange,

42

Чад

airtel, any, salam, tigo,

43

Германия

any, fonic, lebara, lycamobile, o2, ortel_mobile, telekom, vodafone,

44

Литва

any, tele2, telia,

45

Хорватия

a1, any, tele2, tmobile,

46

Швеция

any, comviq, lycamobile, tele2, telenor, telia, three, vectone, vodafone,

47

Ирак

any, asiacell, korek, zain,

48

Нидерланды

any, kpn, lebara, lycamobile, l_mobi, tmobile, vodafone,

49

Латвия

any, tele2,

50

Австрия

a1, any, orange, telering, three, tmobile,

51

Беларусь

any, life, mdc, mts,

52

Таиланд

ais, any, dtac, truemove,

53

Сауд. Аравия

any,

54

Мексика

any, telcel,

55

Тайвань

any, chunghwa, fareast,

56

Испания

any, lebara, lycamobile, orange, you_mobile,

57

Иран

any, aptel, azartel, hamrah_e_aval, irancell, rightel, samantel, shatel, taliya,

58

Алжир

any, djezzy, mobilis, ooredoo,

59

Словения

any,

60

Бангладеш

any,

61

Сенегал

any, expresso, free, orange,

62

Турция

any, turkcell,

63

Чехия

any, o2, tmobile, vodafone,

64

Шри-Ланка

any,

65

Перу

any,

66

Пакистан

any,

67

Новая Зеландия

2degree, any, vodafone,

68

Гвинея

any, cellcom, mtn, orange,

69

Мали

any, malitel, orange, telecel,

70

Венесуэла

any,

71

Эфиопия

any,

72

Монголия

any, beeline,

73

Бразилия

algartelecom, any, claro, correios_celular, oi, tim, vivo,

74

Афганистан

any, salaam,

75

Уганда

airtel, any, k2_telecom, lycamobile, mtn, orange, smart, smile, uganda_telecom,

76

Ангола

any,

77

Кипр

any, cyta, epic, lemontel, primetel, vectone,

78

Франция

any, lebara, lycamobile, orange, sfr, syma_mobile, vectone,

79

Новая Гвинея

any,

80

Мозамбик

any,

81

Непал

any,

82

Бельгия

any,

83

Болгария

any,

84

Венгрия

any,

85

Молдова

any, moldcell, orange, unite,

86

Италия

any,

87

Парагвай

any,

88

Гондурас

any,

89

Тунис

any,

90

Никарагуа

any,

91

Тимор-Лесте

any,

92

Боливия

any,

93

Коста Рика

any,

94

Гватемала

any, claro, movistar, tigo,

95

ОАЭ

any,

96

Зимбабве

any,

97

Пуэрто-Рико

any,

98

Судан

any, mtn, sudani_one, zain,

99

Того

any,

100

Кувейт

any,

101

Сальвадор

any,

102

Ливия

any,

103

Ямайка

any, digi,

104

Тринидад и Тобаго

any,

105

Эквадор

any,

106

Свазиленд

any,

107

Оман

any,

108

Босния и Герцеговина

any,

109

Доминиканская Республика

altice, any, claro, viva,

111

Катар

any,

113

Куба

any,

112

Панама

any,

114

Мавритания

any, chinguitel, mattel, mauritel,

115

Сьерра-Леоне

africel, airtel, any, qcell,

116

Иордания

any, orange, umniah, xpress, zain,

117

Португалия

any, lycamobile, vodafone,

118

Барбадос

any,

119

Бурунди

any,

120

Бенин

any,

121

Бруней

any,

122

Багамы

any,

123

Ботсвана

any, be_mobile, mascom, orange,

124

Белиз

any,

125

ЦАР

any,

126

Доминика

any,

127

Гренада

any,

128

Грузия

any, beeline, geocell, hamrah_e_aval, magticom,

129

Греция

any, cosmote, q_telecom, vodafone,

130

Гвинея-Бисау

any,

131

Гайана

any,

132

Исландия

any,

133

Коморы

any,

134

Сент-Китс и Невис

any,

135

Либерия

any, cellcom, comium, libercell, libtelco, lonestar,

136

Лесото

any,

137

Малави

any,

138

Намибия

any,

139

Нигер

any,

140

Руанда

any,

141

Словакия

any,

142

Суринам

any,

143

Таджикистан

any,

144

Монако

any,

145

Бахрейн

any,

146

Реюньон

any,

147

Замбия

any,

148

Армения

any,

149

Сомали

any,

150

Конго

any,

151

Чили

any,

152

Буркина-Фасо

airtel, any, onatel, telecel,

153

Ливан

alfa, any, ogero, touch,

154

Габон

any,

155

Албания

any,

156

Уругвай

any,

157

Маврикий

any,

158

Бутан

any,

159

Мальдивы

any,

160

Гваделупа

any,

161

Туркменистан

any,

162

Французская Гвиана

any,

163

Финляндия

any,

164

Сент-Люсия

any,

165

Люксембург

any,

166

Сент-Винсент и Гренадин

any,

167

Экваториальная Гвинея

any,

168

Джибути

any,

169

Антигуа и Барбуда

any,

170

Острова Кайман

any,

171

Черногория

any,

172

Дания

any, lycamobile,

173

Швейцария

any,

174

Норвегия

any,

175

Австралия

any,

176

Эритрея

any,

177

Южный Судан

any,

178

Сан-Томе и Принсипи

any,

179

Аруба

any,

180

Монтсеррат

any,

181

Ангилья

any,

182

Япония

any,

183

Северная Македония

any,

184

Республика Сейшелы

any,

185

Новая Каледония

any,

186

Кабо-Верде

any,

187

США

any, lycamobile, tmobile,

190

Южная Корея

any,

189

Фиджи

any,

195

Бермуды

any,

Приложение 2. Список сервисов

ID

Наименование

vk

Вконтакте

ok

Одноклассники

wa

Whatsapp

vi

Viber

tg

Telegram

wb

WeChat

go

Google,youtube,Gmail

av

avito

fb

facebook

tw

Twitter

ub

Uber

qw

Кивиус

gt

Gett

sn

OLX

ig

Instagram

ss

Hezzl

ym

Юла

ma

Mail.ru

mm

Microsoft

uk

Airbnb

me

Line messenger

mb

Yahoo

we

ДругВокруг

bd

Пятерочка

kp

HQ Trivia

dt

Delivery Club

ya

Яндекс

mt

Steam

oi

Tinder

fd

Mamba, MeetMe

zz

Dent

kt

KakaoTalk

pm

AOL

tn

LinkedIN

qq

Tencent QQ

mg

Магнит

pf

pof.com

yl

Yalla

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

TikTok/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

СпортМастер

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

Перекресток

ip

Burger King

cm

Prom

hw

AliPay

de

Karusel

jc

IVI

rl

inDriver

df

Happn

ui

RuTube

up

Magnolia

nz

Foodpanda

kf

Weibo

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

gl

GlobalTel

zk

Deliveroo

ia

Socios

xl

Wmaraci

yi

Yemeksepeti

ew

Nike

ae

myGLO

gb

YouStar

cy

РСА

qm

RosaKhutor

dh

eBay

yb

Квартплата+

qe

GG

yw

Grindr

uz

OffGamers

gx

Hepsiburadacom

re

Coinbase

tj

dbrUA

ts

PayPal

rt

hily

sf

SneakersnStuff

sv

Dostavista

qi

32red

bz

Blizzard

db

ezbuy

vw

CoinField

zl

Airtel

wf

Airtel

lw

MrGreen

co

Rediffmail

ey

miloan

ge

Paytm

os

Dhani

ql

CMTcuzdan

cq

Mercado

xk

DiDi

py

Monese

rv

Kotak811

jl

Hopi

pr

Trendyol

pu

Justdating

dk

Pairs

fm

Touchance

ph

SnappFood

sw

NCsoft

nr

Tosla

hy

Ininal

tr

Paysend

pq

CDkeys

ff

AVON

sd

dodopizza

ry

McDonalds

le

E bike Gewinnspiel

hr

JKF

qa

MyFishka

wc

Craigslist

kw

Foody

jg

Grab

mj

Zalo

eu

LiveScore

ll

888casino

ed

Gamer

pp

Huya

th

WestStein

xr

Tango

iz

Global24

tk

МВидео

rx

Sheerid

ki

99app

my

CAIXA

zm

OfferUp

tq

Swvl

au

Haraj

ei

Taksheel

rp

hamrahaval

pa

Gamekit

fs

Şikayet var

ul

Getir

cf

irancell

bt

Alfa

ud

Disney Hotstar

qu

Agroinform

un

humblebundle

rm

Faberlic

uo

CafeBazaar

ti

cryptocom

nk

Gittigidiyor

jm

mzadqatar

lp

Algida

si

Cita Previa

fj

Potato Chat

pt

Bitaqaty

qc

Праймериз 2020

yo

Amasia

ve

Dream11

qh

Oriflame

iu

Bykea

ib

Immowelt

zv

Digikala

jb

Wing Money

vn

Yaay

wn

GameArena

bj

Вита экспресс

st

Auchan

ev

Picpay

qn

Blued

cd

SpotHit

vo

Brand20ua

il

IQOS

dx

Powerkredite

el

Bisu

dn

Paxful

lk

PurePlatfrom

vc

Banqi

wj

1хbet

wk

Mobile01

jj

Aitu

an

Adidas

jr

Самокат

nb

Верный

gv

Humta

dw

Divar

gj

Carousell

hc

MOMO

uf

Eneba

kn

Verse

qd

Taobao

hn

1688

zf

OnTaxi

gi

Hotline

uc

Tatneft

mn

RRSA

ak

Douyu

cp

Uklon

qo

Moneylion

wx

Apple

et

Clubhouse

px

Nifty

jh

PingPong

lb

Mailru Group

cn

Fiverr

qz

Faceit

sh

ВкусВилл

ot

Нет в списке

Возможные ошибки

Ответ сервера

Описание

BAD_ACTION

Неправильное формирование запроса

BAD_KEY

Неверный API-ключ

BAD_LANG

Неверная локазация, принимаются ru или en

NO_ACTIVATION

ID активации не существует

ERROR_SQL

Ошибка базы SQL-сервера

ERROR_API

Ошибка обработки