Odbieranie smsów - Dokumentacja API

Dokumentacja API

API to protokół interakcji pomiędzy Twoim OPROGRAMOWANIEM a naszym serwerem aktywacyjnym.

API jest potrzebne w celu zautomatyzowania procesu odbierania wiadomości SMS po Państwa stronie. Wszystkie żądania (obsługiwane przez POST i GET) powinny być kierowane na adres

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

Uwaga

Wszystkie żądania muszą posiadać klucz API-parametr "api_key", lokalizację dla interakcji z saldem rubel/dolar (ru/en)-parametr "lang", nazwę metody-parametr "action".

Klucz API można uzyskać w sekcji:Profil.

getBalance

Aby sprawdzić saldo

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

Pole

Typ

Opis

api_key

string

Twój klucz API zapewnia dostęp do płatnych usług. Klucz API powinien być utrzymywany w tajemnicy.

action

string

Nazwa metody

lang

string

Lokalizacja ru lub pl

Odpowiedź serwera:

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

463.02

getCountryAndOperators

Pobierz wszystkie kraje i operatorów dostępnych dla nich

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

Pole

Typ

Opis

api_key

string

Twój klucz API zapewnia dostęp do płatnych usług. Klucz API powinien być utrzymywany w tajemnicy.

lang

string

Lokalizacja ru lub pl

Odpowiedź serwera:

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

Pole

Przykład

Opis

ID страны

name

Россия

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

operators

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

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

getServicesAndCost

Uzyskaj aktualne ceny i liczbę pokoi

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

Pole

Typ

Opis

api_key

string

Twój klucz API zapewnia dostęp do płatnych usług. Klucz API powinien być utrzymywany w tajemnicy.

operator

string

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

country

integer

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

lang

string

Lokalizacja ru lub pl

Odpowiedź serwera:

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

Pole

Przykład

Opis

ID сервиса

name

Вконтакте

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

price

29.88

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

quantity

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

getNumber

Rezerwacja pokoju

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

Pole

Typ

Opis

api_key

string

Twój klucz API zapewnia dostęp do płatnych usług. Klucz API powinien być utrzymywany w tajemnicy.

action

string

Nazwa metody

service

string

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

operator

string

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

country

integer

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

lang

string

Lokalizacja ru lub pl

Odpowiedź serwera:

Odpowiedź serwera

Przykład

Opis

NO_BALANCE

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

NO_NUMBERS

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

ACCESS_NUMBER:ID:NUMBER

ACCESS_NUMBER:234242:79991728822

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

setStatus

Aby zmienić status

https://sms-service-online.com/stubs/handler_api?api_key=APIKEY&action=setStatus&id=ID&status=STATUS&lang=LANG

Pole

Typ

Opis

api_key

string

Twój klucz API zapewnia dostęp do płatnych usług. Klucz API powinien być utrzymywany w tajemnicy.

action

string

Nazwa metody

integer

Identyfikator aktywacji otrzymany przy zamówieniu numeru

status

integer

Status, który ma zostać przekazany do aktywacji

lang

string

Lokalizacja ru lub pl

Dostępne statusy:

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

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

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

Odpowiedź serwera:

Odpowiedź serwera

Opis

NO_BALANCE

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

ACCESS_CANCEL

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

ACCESS_RETRY_GET

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

ACCESS_ACTIVATION

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

getStatus

Aby uzyskać aktualny status

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

Pole

Typ

Opis

api_key

string

Twój klucz API zapewnia dostęp do płatnych usług. Klucz API powinien być utrzymywany w tajemnicy.

action

string

Nazwa metody

integer

Identyfikator aktywacji otrzymany przy zamówieniu numeru

lang

string

Lokalizacja ru lub pl

Odpowiedź serwera:

Odpowiedź serwera

Opis

STATUS_WAIT_CODE

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

STATUS_CANCEL

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

STATUS_OK:CODE

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

Załącznik 1. Lista krajów

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

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

Rosja

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

Ukraina

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

Kazachstan

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

Chiny

any, chinamobile, china_unicom, unicom,

Anglia (UK)

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

Myanmar

any, telenor,

Indonezja

any, axis, indosat, telkomsel, three,

Malezja

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

Kenia

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

Tanzania

any,

Wietnam

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

Kirgistan

any, beeline, megacom, o!,

USA

any, cellular, tmobile,

Izrael

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

Hongkong

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

Polska

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

Filipiny

any, globe_telecom, smart, tm,

Madagaskar

any,

Dem. Kongo

africel, airtel, any, orange, vodacom,

Nigeria

airtel, any, etisalat, glomobile, mtn,

Makau

any,

Egipt

any, etisalat, orange, vodafone,

Indie

any,

Irlandia

any, lycamobile,

Kambodża

any,

Laos

any, etl, telekom, tplus, unitel,

Haiti

any, natcom,

Wybrzeże Kości Słoniowej

any, moov, mtn, orange,

Gambia

africel, any, comium, gamcel, qcell,

Serbia

any, mobtel, mts, vip,

Jemen

any, mtn, sabafon, yemen_mobile,

AFRYKA POŁUDNIOWA

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

Rumunia

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

Kolumbia

any, claro,

Estonia

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

Azerbejdżan

any,

Kanada (wirtualnie)

any, cellular, lucky, rogers,

Maroko

any, iam, inwi, itissalat, orange,

Ghana

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

Argentyna

any,

Uzbekistan

any, beeline, mts, ucell, uzmobile,

Kamerun

any, mtn, nexttel, orange,

Czad

airtel, any, salam, tigo,

Niemcy

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

Litwa

any, tele2, telia,

Chorwacja

a1, any, tele2, tmobile,

Szwecja

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

Irak

any, asiacell, korek, zain,

Niderlandy

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

Łotwa

any, tele2,

Austria

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

Białoruś

any, life, mdc, mts,

Tajlandia

ais, any, dtac, truemove,

Arabia Saudyjska Arabia Saudyjska

any,

Meksyk

any, telcel,

Tajwan

any, chunghwa, fareast,

Hiszpania

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

Iran

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

Algieria

any, djezzy, mobilis, ooredoo,

Słowenia

any,

Bangladesz

any,

Senegal

any, expresso, free, orange,

Turcja

any, turkcell,

Republika Czeska

any, o2, tmobile, vodafone,

Sri Lanka

any,

Peru

any,

Pakistan

any,

Nowa Zelandia

2degree, any, vodafone,

Gwinea

any, cellcom, mtn, orange,

Mali

any, malitel, orange, telecel,

Wenezuela

any,

Etiopia

any,

Mongolia

any, beeline,

Brazylia

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

Afganistan

any, salaam,

Uganda

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

Angola

any,

Cypr

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

Francja

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

Nowa Gwinea

any,

Mozambik

any,

Nepal

any,

Belgia

any,

Bułgaria

any,

Węgry

any,

Mołdawia

any, moldcell, orange, unite,

Włochy

any,

Paragwaj

any,

Honduras

any,

Tunezja

any,

Nikaragua

any,

Timor Wschodni

any,

Boliwia

any,

Kostaryka

any,

Gwatemala

any, claro, movistar, tigo,

ZJEDNOCZONE EMIRATY ARABSKIE

any,

Zimbabwe

any,

Puerto Rico

any,

Sudan

any, mtn, sudani_one, zain,

Togo

any,

100

Kuwejt

any,

101

Salwador

any,

102

Libia

any,

103

Jamajka

any, digi,

104

Trynidad i Tobago

any,

105

Ekwador

any,

106

Suazi

any,

107

Oman

any,

108

Bośnia i Hercegowina

any,

109

Dominikana

altice, any, claro, viva,

111

Katar

any,

113

Kuba

any,

112

Panama

any,

114

Mauretania

any, chinguitel, mattel, mauritel,

115

Sierra Leone

africel, airtel, any, qcell,

116

Jordania

any, orange, umniah, xpress, zain,

117

Portugalia

any, lycamobile, vodafone,

118

Barbados

any,

119

Burundi

any,

120

Benin

any,

121

Brunei

any,

122

Bahamy

any,

123

Botswana

any, be_mobile, mascom, orange,

124

Belize

any,

125

RCA

any,

126

Dominika

any,

127

Grenada

any,

128

Gruzja

any, beeline, geocell, hamrah_e_aval, magticom,

129

Grecja

any, cosmote, q_telecom, vodafone,

130

Gwinea Bissau

any,

131

Gujana

any,

132

Islandia

any,

133

Komory

any,

134

Saint Kitts i Nevis

any,

135

Liberia

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

136

Lesotho

any,

137

Malawi

any,

138

Namibia

any,

139

Niger

any,

140

Rwanda

any,

141

Słowacja

any,

142

Surinam

any,

143

Tadżykistan

any,

144

Monako

any,

145

Bahrajn

any,

146

Reunion

any,

147

Zambia

any,

148

Armenia

any, viva, vivo,

149

Somalia

any,

150

Kongo

any,

151

Chile

any,

152

Burkina Faso

airtel, any, onatel, telecel,

153

Liban

alfa, any, ogero, touch,

154

Gabon

any,

155

Albania

any,

156

Urugwaj

any,

157

Mauritius

any,

158

Bhutan

any,

159

Malediwy

any,

160

Gwadelupa

any,

161

Turkmenistan

any,

162

Gujana Francuska

any,

163

Finlandia

any,

164

Saint Lucia

any,

165

Luksemburg

any,

166

Saint Pierre i Miquelon

any,

167

Gwinea Równikowa

any,

168

Dżibuti

any,

169

Saint Kitts i Nevis

any,

170

Kajmany

any,

171

Czarnogóra

any,

172

Dania

any, lycamobile,

173

Szwajcaria

any,

174

Norwegia

any,

175

Australia

any,

176

Erytrea

any,

177

Sudan Południowy

any,

178

Wyspy Świętego Tomasza i Książęca

any,

179

Aruba

any,

180

Montserrat

any,

181

Anguilla

any,

182

Japonia

any,

183

Macedonia Północna

any,

184

Republika Seszeli

any,

185

Nowa Kaledonia

any,

186

Republika Zielonego Przylądka

any,

187

USA

any, lycamobile, tmobile,

190

Korea Południowa

any,

189

Fidżi

any,

195

Bermudy

any,

Załącznik 2. Lista usług

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

Grindr

РСА

Tencent QQ

Квартплата+

Gojek

Swvl

YouStar

Skroutz

Setel

KFC

Lenta

GoFundMe

OfferUp

Switips

Tosla

TradingView

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

humblebundle

Revolut

Mail.ru

OffGamers

CliQQ

Meliuz

premium.one

HQ Trivia

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

Sizeer

Airbnb

Burger King

SuperS

Uklon

MapleSEA

iQIYI

Cita Previa

Перекресток

Twitter

Киви

ssoidnet

Megogo

Fiverr

МВидео

hamrahaval

Socios

pof.com

Rediffmail

CAIXA

Праймериз 2020

Coinbase

ProtonMail

Icrypex

Truecaller

Band

Iwplay

Giftcloud

Zalo

Tinder

MyMusicTaste

AgriDevelop

ЗдравСити

Lamoda

Около

Hotline

SnappFood

Inboxlv

CafeBazaar

Pyro Music

CoinField

Iti

Divar

Lidl

McDonalds

Tatneft

СберМаркет

Prom

Gamer

MOMO

Allegro

Not in list

X5ID

Foody

Okko

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

Pairs

Taobao

Dent

Ok.ru

Line msg

Huya

OLX

ВкусВилл

BlaBlaCar

Carousell

Baidu

WestStein

Rozetka

Betfair

dodopizza

Yaay

Zilch

TanTan

Humta

PayPal

Olacabs

WeChat

СпортМастер

IndiaGold

Alfa

Юла

Delivery Club

Bisu

Karusel

Vivo

Viber

Picpay

KazanExpress

163СOM

Imo

Mailru Group

Mylove

Douyu

ezbuy

kufarby

Grab

Microsoft

RuTube

Surveytime

Вконтакте

TikTok/Douyin

IFood

EasyPay

kolesa.kz

YouGotaGift

OnTaxi

paycell

GlobalTel

Магнит

Santander

Paxful

Payberry

Magnolia

Banqi

GalaxyWin

CMTcuzdan

Indomaret

Touchance

Instagram

PGbonus

Hermes

Onet

99app

Whoosh

MPL

Keybase

MrQ

Gett

Mobile01

SpotHit

Fastmail

HandyPick

PaddyPower

BitClout

Michat

Gittigidiyor

Monese

Hopi

Digikala

IVI

Poshmark

Seosprint

SneakersnStuff

JDcom

Twilio

Drom

Zoho

ДругВокруг

Adidas

RoyalWin

Q12 Trivia

HeyBox

Algida

Sheerid

Payzapp

Weibo

Blued

Potato Chat

LiveScore

PurePlatfrom

Zomato

Haraj

irancell

IQOS

Amasia

KakaoTalk

Noon

Careem

Bykea

Nanovest

eBay

GroupMe

Uber

AliPay

Trendyol

Tango

Şikayet var

miloan

GalaxyChat

Kwai

MTS CashBack

AOL

dbrUA

Trip

Верный

Netflix

Rambler

Onlinerby

OkCupid

NoBroker

Aitu

Dream11

OVO

AVON

BillMill

Ininal

Paytm

ChaingeFinance

Taksheel

RedBook

Paysafecard

CDkeys

Brand20ua

Likee

Papara

Powerkredite

Możliwy błąd

Odpowiedź serwera

Opis

BAD_ACTION

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

BAD_KEY

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

BAD_LANG

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

NO_ACTIVATION

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

ERROR_SQL

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

ERROR_API

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