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

Rusko

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

1

Ukrajina

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

2

Kazachstán

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

3

Čína

any, chinamobile, china_unicom, unicom,

16

Anglie (Spojené království)

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

5

Myanmar

any, telenor,

6

Indonésie

any, axis, indosat, telkomsel, three,

7

Malajsie

any, celcom, digi, hotlink, u_mobile, xox,

8

Keňa

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

9

Tanzanie

any,

10

Vietnam

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

11

Kyrgyzstán

any, beeline, megacom, o!,

12

USA

any, cellular, tmobile,

13

Izrael

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

14

Hongkong

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

15

Polsko

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

4

Filipíny

any, globe_telecom, smart, tm,

17

Madagaskar

any,

18

Dem. Kongo

africel, airtel, any, orange, vodacom,

19

Nigérie

airtel, any, etisalat, glomobile, mtn,

20

Macao

any,

21

Egypt

any, etisalat, orange, vodafone,

22

Indie

any,

23

Irsko

any, lycamobile,

24

Kambodža

any,

25

Laos

any, etl, telekom, tplus, unitel,

26

Haiti

any, natcom,

27

Pobřeží slonoviny

any, moov, mtn, orange,

28

Gambie

africel, any, comium, gamcel, qcell,

29

Srbsko

any, mobtel, mts, vip,

30

Jemen

any, mtn, sabafon, yemen_mobile,

31

JIŽNÍ AFRIKA

any, cell_c, lycamobile, mtn, telkom, vodacom,

32

Rumunsko

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

33

Kolumbie

any, claro,

34

Estonsko

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

35

Ázerbájdžán

any,

36

Kanada (virtuální)

any, cellular, fido, lucky, rogers, telus,

37

Maroko

any, iam, inwi, itissalat, orange,

38

Ghana

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

39

Argentina

any,

40

Uzbekistán

any, beeline, mts, ucell, uzmobile,

41

Kamerun

any, mtn, nexttel, orange,

42

Čad

airtel, any, salam, tigo,

43

Německo

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

44

Litva

any, tele2, telia,

45

Chorvatsko

a1, any, tele2, tmobile,

46

Švédsko

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

47

Irák

any, asiacell, korek, zain,

48

Nizozemsko

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

49

Lotyšsko

any, bite, lmt, tele2,

50

Rakousko

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

51

Bělorusko

any, life, mdc, mts,

52

Thajsko

ais, any, dtac, truemove,

53

Saúdská Arábie Saúdská Arábie

any,

54

Mexiko

any, telcel,

55

Tchaj-wan

any, chunghwa, fareast,

56

Španělsko

altecom, any, euskaltel, lebara, lycamobile, movistar, orange, vodafone, yoigo, you_mobile,

57

Írán

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

58

Alžírsko

any, djezzy, mobilis, ooredoo,

59

Slovinsko

any,

60

Bangladéš

any,

61

Senegal

any, expresso, free, orange,

62

Turecko

any, turkcell,

63

Česká republika

any, o2, tmobile, vodafone,

64

Srí Lanka

any,

65

Peru

any,

66

Pákistán

any,

67

Nový Zéland

2degree, any, vodafone,

68

Guinea

any, cellcom, mtn, orange,

69

Mali

any, malitel, orange, telecel,

70

Venezuela

any,

71

Etiopie

any,

72

Mongolsko

any, beeline,

73

Brazílie

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

74

Afghánistán

any, salaam,

75

Uganda

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

76

Angola

any,

77

Kypr

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

78

Francie

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

79

Nová Guinea

any,

80

Mozambik

any,

81

Nepál

any,

82

Belgie

any,

83

Bulharsko

any,

84

Maďarsko

any,

85

Moldavsko

any, moldcell, orange, unite,

86

Itálie

any,

87

Paraguay

any,

88

Honduras

any,

89

Tunisko

any,

90

Nikaragua

any,

91

Východní Timor

any,

92

Bolívie

any,

93

Kostarika

any,

94

Guatemala

any, claro, movistar, tigo,

95

SJEDNOCENÉ ARABSKÉ EMIRÁTY

any,

96

Zimbabwe

any,

97

Portoriko

any,

98

Súdán

any, mtn, sudani_one, zain,

99

Togo

any,

100

Kuvajt

any,

101

Salvador

any, claro, digi, movistar, red, tigo,

102

Libye

any,

103

Jamajka

any, digi,

104

Trinidad a Tobago

any,

105

Ekvádor

any, cnt_mobile, tuenti,

106

Svazijsko

any,

107

Omán

any,

108

Bosna a Hercegovina

any,

109

Dominikánská republika

altice, any, claro, viva,

111

Katar

any,

113

Kuba

any,

112

Panama

any,

114

Mauretánie

any, chinguitel, mattel, mauritel,

115

Sierra Leone

africel, airtel, any, qcell,

116

Jordánsko

any, orange, umniah, xpress, zain,

117

Portugalsko

any, lycamobile, vodafone,

118

Barbados

any,

119

Burundi

any,

120

Benin

any,

121

Brunej

any,

122

Bahamy

any,

123

Botswana

any, be_mobile, mascom, orange,

124

Belize

any,

125

STŘEDOAFRICKÁ REPUBLIKA

any,

126

Dominika

any,

127

Grenada

any,

128

Gruzie

any, beeline, geocell, hamrah_e_aval, magticom,

129

Řecko

any, cosmote, q_telecom, vodafone,

130

Guinea-Bissau

any,

131

Guyana

any,

132

Island

any,

133

Komory

any,

134

Svatý Kryštof a Nevis

any,

135

Libérie

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

136

Lesotho

any,

137

Malawi

any,

138

Namibie

any,

139

Niger

any,

140

Rwanda

any,

141

Slovensko

any,

142

Surinam

any,

143

Tádžikistán

any,

144

Monako

any,

145

Bahrajn

any,

146

Reunion

any,

147

Zambie

any,

148

Arménie

any, viva, vivo,

149

Somálsko

any,

150

Kongo

any,

151

Chile

any, claro,

152

Burkina Faso

airtel, any, onatel, telecel,

153

Libanon

alfa, any, ogero, touch,

154

Gabon

any,

155

Albánie

any,

156

Uruguay

any,

157

Mauricius

any,

158

Bhútán

any,

159

Maledivy

any,

160

Guadeloupe

any,

161

Turkmenistán

any,

162

Francouzská Guyana

any,

163

Finsko

any,

164

Svatá Lucie

any,

165

Lucembursko

any,

166

Saint Pierre a Miquelon

any,

167

Rovníková Guinea

any,

168

Džibutsko

any,

169

Svatý Kryštof a Nevis

any,

170

Kajmanské ostrovy

any,

171

Černá Hora

any,

172

Dánsko

any, lycamobile,

173

Švýcarsko

any,

174

Norsko

any,

175

Austrálie

any,

176

Eritrea

any,

177

Jižní Súdán

any,

178

Svatý Tomáš a Princův ostrov

any,

179

Aruba

any,

180

Montserrat

any,

181

Anguilla

any,

182

Japonsko

any,

183

Severní Makedonie

any,

184

Seychelská republika

any,

185

Nová Kaledonie

any,

186

Kapverdy

any,

187

USA

any, lycamobile, tmobile,

190

Jižní Korea

any,

189

Fidži

any,

195

Bermudy

any,

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

ID

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

ug

Fiqsy

hu

Ukrnet

bv

Metro

lj

Santander

jg

Grab

de

Karusel

hg

Switips

qr

MEGA

fu

Snapchat

la

ssoidnet

ni

Gojek

mt

Steam

qw

Kiwi

ed

Gamer

zm

OfferUp

zz

Dent

qa

MyFishka

ph

SnappFood

zs

Bilibili

wx

Apple

sb

Lamoda

yu

Xiaomi

zf

OnTaxi

vm

OkCupid

kl

kolesa.kz

yi

Yemeksepeti

me

Line messenger

po

premium.one

ku

RoyalWin

dl

Lazada

an

Adidas

td

ChaingeFinance

ey

miloan

rz

EasyPay

cn

Fiverr

rp

hamrahaval

vg

ShellBox

zl

Airtel

ys

ZCity

go

Google,youtube,Gmail

uy

Meliuz

ui

RuTube

ne

Coindcx

xj

СберМаркет

nf

Netflix

ds

Discord

ad

Iti

et

Clubhouse

av

avito

rv

Kotak811

sw

NCsoft

cd

SpotHit

yo

Amasia

jc

IVI

dw

Divar

st

Auchan

jq

Paysafecard

nz

Foodpanda

pt

Bitaqaty

qn

Blued

xl

Wmaraci

lf

TikTok/Douyin

pg

NRJ Music Awards

cc

Quipp

mf

Weidian

li

Baidu

rt

hily

dk

Pairs

bf

Keybase

kp

HQ Trivia

yg

CourseHero

zh

Zoho

vi

Viber

wb

WeChat

gw

CallApp

kr

Eyecon

ud

Disney Hotstar

sg

OZON

ww

BIP

gt

Gett

nn

Giftcloud

fs

Şikayet var

pp

Huya

pz

Lidl

vo

Brand20ua

nq

Trip

os

Dhani

lb

Mailru Group

rx

Sheerid

qk

Bit

wj

1хbet

aw

Taikang

cq

Mercado

hc

MOMO

ka

Shopee

vp

Kwai

lt

BitClout

rl

inDriver

ma

Mail.ru

oh

MapleSEA

px

Nifty

ki

99app

gl

GlobalTel

hy

Ininal

jf

Likee

be

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

ej

MrQ

nk

Gittigidiyor

qh

Oriflame

sl

СберАптека

uu

Wildberries

yz

Около

mj

Zalo

wk

Mobile01

vf

Q12 Trivia

mc

Michat

fm

Touchance

da

MTS CashBack

ax

CrefisaMais

nb

Faithful

qi

32red

tr

Paysend

vk

Contact

je

Nanovest

yf

Citymobil

tw

Twitter

ju

Indomaret

ra

KeyPay

ge

Paytm

iu

Bykea

dn

Paxful

mg

Magnet

tj

dbrUA

dz

Dominos Pizza

qu

Agroinform

tk

MVideo

ab

Alibaba

yb

Square+

sj

HandyPick

kf

Weibo

tq

Swvl

mk

LongHu

md

Банки

hz

Drom

wt

IZI

hb

Twitch

ql

CMTcuzdan

qj

Whoosh

fb

facebook

bt

Alfa

en

Hermes

uc

Tatneft

zw

Quack

cp

Uklon

mu

MyMusicTaste

ue

Onet

lk

PurePlatfrom

rj

Детский мир

ll

888casino

fd

Mamba, MeetMe

sk

Skroutz

zy

Nttgame

vx

HeyBox

yn

Allegro

fx

PGbonus

xh

OVO

bj

Vita Express

dp

ProtonMail

fi

Dundle

xv

Wish

ae

myGLO

ou

Gabi

ny

Pyro Music

iy

FoodHub

jr

Scooter

wp

163СOM

ce

mosru

co

Rediffmail

nr

Tosla

ti

cryptocom

kb

kufarby

dx

Powerkredite

pu

Justdating

il

IQOS

ym

Yula

wh

TanTan

xi

InFund

rr

Wolt

df

Happn

qz

Faceit

ua

BlaBlaCar

ji

Monobank

fj

Potato Chat

pf

pof.com

hx

AliExpress

ib

Immowelt

uf

Eneba

dv

NoBroker

gp

Ticketmaster

le

E bike competition

vn

Yaay

yw

Grindr

ya

Yandex

gj

Carousell

wa

Whatsapp

ok

Odnoklassniki

kn

Verse

gv

Humta

tt

Ziglu

xr

Tango

mr

Fastmail

sn

OLX

gb

YouStar

qc

2020 primaries

bd

Pyaterochka

xz

paycell

uk

Airbnb

vd

Betfair

pm

AOL

iv

Inboxlv

lv

Megogo

nv

Naver

iq

icq

xq

MPL

bz

Blizzard

ul

Getir

ch

Pocket52

aq

Glovo

iz

Global24

cm

Prom

kc

Vinted

kx

Vivo

am

Amazon

zk

Deliveroo

dh

eBay

we

FriendAround

wg

Skout

xs

GroupMe

sv

Dostavista

qm

RosaKhutor

ft

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

km

Rozetka

el

Bisu

mm

Microsoft

ee

Twilio

vc

Banqi

np

Siply

ew

Nike

qf

RedBook

sh

TasteVille

kt

CocoaTalk

re

Coinbase

lw

MrGreen

th

WestStein

tl

Truecaller

pl

Crossroads

tc

Rambler

rm

Faberlic

zr

Papara

wf

Airtel

ev

Picpay

zg

Setel

ig

Instagram

vw

CoinField

eu

LiveScore

ga

Roposo

kw

Foody

es

iQIYI

ri

BillMill

ol

KazanExpress

cf

irancell

mn

RRSA

sq

KuCoinPlay

oi

Tinder

pr

Trendyol

og

Okko

za

JDcom

pa

Gamekit

tg

Telegram

xf

LightChat

hm

Globe

ei

Taksheel

hk

4Fun

ob

Onlinerby

fz

KFC

tm

Akulaku

au

Haraj

cs

AgriDevelop

xk

DiDi

my

CAIXA

lx

DewuPoison

zo

Kaggle

zn

Biedronka

xe

GalaxyChat

dm

Iwplay

ia

Socios

hn

1688

rd

Air

gx

Hepsiburadacom

tn

LinkedIN

tp

IndiaGold

yl

Yalla

ts

PayPal

bl

BIGO LIVE

py

Monese

af

GalaxyWin

wn

GameArena

ff

AVON

az

CityBase

ry

McDonalds

jj

Aitu

sf

SneakersnStuff

qq

Tencent QQ

jb

Wing Money

uh

Yubo

pd

IFood

jl

Hopi

io

ЗдравСити

eo

Sizeer

jh

PingPong

kz

NimoTV

qe

GG

bo

Wise

uz

OffGamers

qb

Payberry

va

SportGully

ls

Careem

cw

PaddyPower

zd

Zilch

fr

Dana

gc

TradingView

si

Cita Previa

vv

Seosprint

cx

Icrypex

dy

Zomato

nu

Stripe

uj

СhampionСasino

vy

Meta

hw

AliPay

qd

Taobao

ip

Burger King

ea

JamesDelivery

hr

JKF

ub

Uber

ke

Эльдорадо

gd

Surveytime

dt

Delivery Club

hl

Band

pq

CDkeys

tx

Shop

hj

Столото

zv

Digikala

ak

Douyu

ot

Není uvedeno

ss

Hezzl

ca

SuperS

uo

CafeBazaar

jm

mzadqatar

im

Imo

bp

GoFundMe

yk

SportMaster

ly

Olacabs

fy

Mylove

gz

LYKA

lr

Okta

yp

Payzapp

up

Magnolia

ve

Dream11

qo

Moneylion

fe

CliQQ

mb

Yahoo

gi

Hotline

oz

Poshmark

wc

Craigslist

gm

Mocospace

db

ezbuy

cy

RSA

op

MIRATORG

sd

dodopizza

tf

Noon

lp

Algida

lq

Potato

un

humblebundle

ij

Revolut

wl

YouGotaGift

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

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

Описание

BAD_ACTION

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

BAD_KEY

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

BAD_LANG

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

NO_ACTIVATION

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

ERROR_SQL

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

ERROR_API

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