Прием смс - Документация 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, xox,

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, smartone, 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, cell_c, 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, iam, 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

Испания

altecom, any, euskaltel, lebara, lycamobile, movistar, orange, vodafone, yoigo, 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, viva, vivo,

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

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

yw

Grindr

cy

РСА

qq

Tencent QQ

yb

Квартплата+

ni

Gojek

tq

Swvl

gb

YouStar

sk

Skroutz

zg

Setel

fz

KFC

rd

Lenta

bp

GoFundMe

zm

OfferUp

hg

Switips

nr

Tosla

gc

TradingView

be

СберМегаМаркет

un

humblebundle

ij

Revolut

ma

Mail.ru

uz

OffGamers

fe

CliQQ

uy

Meliuz

po

premium.one

kp

HQ Trivia

bj

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

eo

Sizeer

uk

Airbnb

ip

Burger King

ca

SuperS

cp

Uklon

oh

MapleSEA

es

iQIYI

si

Cita Previa

pl

Перекресток

tw

Twitter

qw

Киви

la

ssoidnet

lv

Megogo

cn

Fiverr

tk

МВидео

rp

hamrahaval

ia

Socios

pf

pof.com

co

Rediffmail

my

CAIXA

qc

Праймериз 2020

re

Coinbase

dp

ProtonMail

cx

Icrypex

tl

Truecaller

hl

Band

dm

Iwplay

nn

Giftcloud

mj

Zalo

oi

Tinder

mu

MyMusicTaste

cs

AgriDevelop

io

ЗдравСити

sb

Lamoda

yz

Около

gi

Hotline

ph

SnappFood

iv

Inboxlv

uo

CafeBazaar

ny

Pyro Music

vw

CoinField

ad

Iti

dw

Divar

pz

Lidl

ry

McDonalds

uc

Tatneft

xj

СберМаркет

cm

Prom

ed

Gamer

hc

MOMO

yn

Allegro

ot

Not in list

bd

X5ID

kw

Foody

og

Okko

ft

Букмекерские

dk

Pairs

qd

Taobao

zz

Dent

ok

Ok.ru

me

Line msg

pp

Huya

sn

OLX

sh

ВкусВилл

ua

BlaBlaCar

gj

Carousell

li

Baidu

th

WestStein

km

Rozetka

vd

Betfair

sd

dodopizza

vn

Yaay

zd

Zilch

wh

TanTan

gv

Humta

ts

PayPal

ly

Olacabs

wb

WeChat

yk

СпортМастер

tg

Telegram

tp

IndiaGold

bt

Alfa

ym

Юла

dt

Delivery Club

el

Bisu

de

Karusel

kx

Vivo

vi

Viber

ev

Picpay

ol

KazanExpress

wp

163СOM

im

Imo

lb

Mailru Group

fy

Mylove

ak

Douyu

db

ezbuy

kb

kufarby

jg

Grab

mm

Microsoft

ui

RuTube

gd

Surveytime

vk

Вконтакте

lf

TikTok/Douyin

pd

IFood

rz

EasyPay

kl

kolesa.kz

wl

YouGotaGift

zf

OnTaxi

xz

paycell

gl

GlobalTel

mg

Магнит

lj

Santander

dn

Paxful

qb

Payberry

up

Magnolia

vc

Banqi

af

GalaxyWin

ql

CMTcuzdan

ju

Indomaret

fm

Touchance

ig

Instagram

fx

PGbonus

en

Hermes

ue

Onet

ki

99app

qj

Whoosh

xq

MPL

bf

Keybase

ej

MrQ

gt

Gett

wk

Mobile01

cd

SpotHit

mr

Fastmail

sj

HandyPick

cw

PaddyPower

lt

BitClout

mc

Michat

nk

Gittigidiyor

py

Monese

jl

Hopi

zv

Digikala

jc

IVI

oz

Poshmark

vv

Seosprint

sf

SneakersnStuff

za

JDcom

ee

Twilio

hz

Drom

zh

Zoho

we

ДругВокруг

an

Adidas

ku

RoyalWin

vf

Q12 Trivia

vx

HeyBox

lp

Algida

rx

Sheerid

yp

Payzapp

kf

Weibo

qn

Blued

fj

Potato Chat

eu

LiveScore

lk

PurePlatfrom

dy

Zomato

au

Haraj

cf

irancell

il

IQOS

yo

Amasia

kt

KakaoTalk

tf

Noon

ls

Careem

iu

Bykea

je

Nanovest

dh

eBay

xs

GroupMe

ub

Uber

hw

AliPay

pr

Trendyol

xr

Tango

fs

Şikayet var

ey

miloan

xe

GalaxyChat

vp

Kwai

da

MTS CashBack

pm

AOL

tj

dbrUA

nq

Trip

nb

Верный

nf

Netflix

tc

Rambler

ob

Onlinerby

vm

OkCupid

dv

NoBroker

jj

Aitu

ve

Dream11

wa

Whatsapp

xh

OVO

ff

AVON

ri

BillMill

hy

Ininal

ge

Paytm

td

ChaingeFinance

ei

Taksheel

qf

RedBook

jq

Paysafecard

pq

CDkeys

vo

Brand20ua

jf

Likee

zr

Papara

dx

Powerkredite

vy

Meta

zy

Nttgame

ji

Monobank

os

Dhani

lx

DewuPoison

rv

Kotak811

wn

GameArena

qo

Moneylion

lq

Potato

ch

Pocket52

ss

Hezzl

gw

CallApp

jm

mzadqatar

ke

Эльдорадо

px

Nifty

bl

BIGO LIVE

fi

Dundle

dz

Dominos Pizza

ae

myGLO

jb

Wing Money

ib

Immowelt

jr

Самокат

np

Siply

bz

Blizzard

cq

Mercado

md

Банки

yl

Yalla

ul

Getir

qi

23red

op

MIRATORG

sq

KuCoinPlay

wt

IZI

gp

Ticketmaster

mt

Steam

ll

888casino

kr

Eyecon

tm

Akulaku

go

Google,youtube,Gmail

qu

Agroinform

sv

Dostavista

tn

LinkedIN

zo

Kaggle

az

CityBase

fd

Mamba

ya

Яндекс

ew

Nike

hb

Twitch

qm

RosaKhutor

va

SportGully

nv

Naver

pt

Bitaqaty

iz

Global24

rt

hily

hu

Ukrnet

uj

СhampionСasino

rl

inDriver

et

Clubhouse

yu

Xiaomi

tr

Paysend

qh

Oriflame

hm

Globus

wx

Apple

hn

1688

hr

JKF

xi

InFund

ea

JamesDelivery

xl

Wmaraci

ab

Alibaba

ww

BIP

nz

Foodpanda

rr

Wolt

hj

Столото

gz

LYKA

mn

RRSA

wg

Skout

rm

Faberlic

mb

Yahoo

zl

Airtel

sw

NCsoft

kc

Vinted

zn

Biedronka

hk

4Fun

wf

YandexGo

qk

Bit

am

Amazon

gm

Mocospace

sg

OZON

cc

Quipp

ti

cryptocom

ud

Disney Hotstar

xf

LightChat

kn

Verse

tx

Bolt

bo

Wise

sl

СберАптека

wc

Craigslist

ce

mosru

lr

Okta

ka

Shopee

fu

Snapchat

lw

MrGreen

yg

CourseHero

st

Auchan

xv

Wish

yi

Yemeksepeti

uh

Yubo

ug

Fiqsy

ga

Roposo

ou

Gabi

xk

DiDi

uu

Wildberries

yf

Citymobil/Urent

iq

icq

nu

Stripe

gx

Hepsiburadacom

av

avito

pa

Gamekit

kz

NimoTV

rj

Детский мир

ra

KeyPay

wj

1хbet

zw

Quack

pg

NRJ Music Awards

qz

Faceit

vg

ShellBox

zs

Bilibili

dl

Lazada

le

E bike Gewinnspiel

qa

MyFishka

zk

Deliveroo

tt

Ziglu

jh

PingPong

pu

Justdating

bv

Metro

qr

MEGA

uf

Eneba

ds

Discord

qe

GG

df

Happn

aq

Glovo

fb

facebook

hx

AliExpress

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

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

Описание

BAD_ACTION

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

BAD_KEY

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

BAD_LANG

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

NO_ACTIVATION

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

ERROR_SQL

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

ERROR_API

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