Odbieranie sms - Dokumentacja API

Dokumentacja API

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

API jest potrzebne, aby zautomatyzować proces otrzymywania wiadomości SMS po Twojej stronie. Wszystkie zapytania (obsługiwane przez POST i GET) powinny trafiać do

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

Uwaga

Wszystkie żądania muszą mieć parametr API klucz-parametr "api_key", lokalizację do interakcji z rublem / dolarem (ru/en) parametr salda "lang", nazwa metody-parametr "akcja".

Klucz API możesz uzyskać w dziale:Profil.

getBalance

Aby sprawdzić saldo

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

Pole

Rodzaj

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 en

Odpowiedź serwera:

Przykładowa odpowiedź:

463.02

getCountryAndOperators

Uzyskaj dostęp do wszystkich krajów i operatorów

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

Pole

Rodzaj

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 en

Odpowiedź serwera:

Przykładowa odpowiedź JSON:

[{"id":0,"name":"Rosja","operators":{"any":"any","tele2":"tele2","tinkoff":"tinkoff","ttk":"ttk","yota":"yota"}},{"id":1,"name":"Ukraina","operators":{"any":"any","kyivstar":"kyivstar","life":"life","lycamobile":"lycamobile","mts":"mts","utel":"utel","vodafone":"vodafone"}}]

Pole

Przykład

Opis

Identyfikator kraju

name

Rosja

Nazwa kraju

operators

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

Tablica z identyfikatorami operatorów

getServicesAndCost

Sprawdź aktualne ceny i liczbę numerów

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

Pole

Rodzaj

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

Operator komórkowy, którego numer ma zostać uzyskany patrz. "Lista krajów"

country

integer

Identyfikator kraju, którego numer chcesz uzyskać, zobacz "Lista krajów"

lang

string

Lokalizacja ru lub en

Odpowiedź serwera:

Przykładowa odpowiedź 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

Identyfikator usługi

name

Вконтакте

Nazwa serwisu

price

29.88

Aktualna cena

quantity

Liczba liczb

getNumber

Rezerwacja numeru

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

Pole

Rodzaj

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

Numer usługi, dla którego chcesz się zobaczyć. "Lista usług"

operator

string

Operator komórkowy, którego numer ma zostać uzyskany patrz. "Lista krajów"

country

integer

Identyfikator kraju, którego numer chcesz uzyskać, zobacz "Lista krajów"

lang

string

Lokalizacja ru lub en

Odpowiedź serwera:

Odpowiedź serwera

Przykład

Opis

NO_BALANCE

Za mało salda na koncie API

NO_NUMBERS

Brak numerów z podanymi parametrami, spróbuj później lub zmień operatora, kraj.

ACCESS_NUMBER:ID:NUMBER

ACCESS_NUMBER:234242:79991728822

Otrzymaliśmy numer, identyfikator aktywacji - ID, sam numer z kodem kraju - 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

Rodzaj

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 podczas prośby o numer

status

integer

Status do przeniesienia do aktywacji

lang

string

Lokalizacja ru lub en

Dostępne statusy:

3 - Poproś o kolejnego SMS-a

6 - Zakończ aktywację

8 - Anuluj zamówienie

Odpowiedź serwera:

Odpowiedź serwera

Opis

NO_BALANCE

Za mało salda na koncie API

ACCESS_CANCEL

Aktywacja anulowana

ACCESS_RETRY_GET

Czekam na nowego SMS-a

ACCESS_ACTIVATION

Aktywacja zakończona pomyślnie

getStatus

Aby uzyskać aktualny status

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

Pole

Rodzaj

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 podczas prośby o numer

lang

string

Lokalizacja ru lub en

Odpowiedź serwera:

Odpowiedź serwera

Opis

STATUS_WAIT_CODE

Czekam na SMS-a

STATUS_CANCEL

Aktywacja anulowana

STATUS_OK:CODE

Otrzymany kod (gdzie CODE to kod aktywacyjny)

getCurrentActivationsList

Aby uzyskać aktualny status

https://sms-service-online.com/stubs/handler_api?api_key=APIKEY&action=getCurrentActivationsList&status=STATUS&limit=LIMIT&order=ORDER&orderBy=ORDERBY&lang=LANG

Pole

Rodzaj

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

status

integer

Numer statusu do filtrowania (dostępny - 0 (nowy, czekam na sms) | 1 (ukończony) | 2 (anulowany) | 3 (otrzymany sms) | 4 (oczekuje na dodatkowy sms))

order

string

Według jakiego pola sortujemy (dostępne - id/numer/data)

orderBy

string

Sortowanie w kolejności rosnącej/malejącej (ASC/DESC)

lang

string

Lokalizacja ru lub en

Odpowiedź serwera:

Przykładowa odpowiedź JSON:

[ { "numberid": 1539723, "number": "380916172774", "status": 1 }, { "numberid": 1081409, "number": "380916147785", "status": 1 } ]

Załącznik 1. Lista krajów

Nazwać

Dostępni operatorzy

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, orange, talk_telecom, three, tmobile, vectone, vodafone,

Myanmar

any, telenor,

Indonezja

any,

Malezja

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

Kenia

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

Tanzania

airtel, any, tigo, vodacom,

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

48mobile, any, lycamobile, tesco,

Kambodża

any, metfone,

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, fido, lucky, rogers, telus,

Maroko

any, iam, inwi, itissalat, orange,

Ghana

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

Argentyna

any,

Uzbekistan

any, beeline, mobiuz, 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, bite, tele2, telia,

Chorwacja

a1, any, tele2, tmobile, tomato,

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, bite, lmt, 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, mtn, rightel, samantel, shatel, taliya, tci,

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

airtel, any, etisalat,

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, cablenet, cyta, epic, lemontel, primetel, vectone,

Francja

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

Nowa Gwinea

any,

Mozambik

any,

Nepal

any,

Belgia

any,

Bułgaria

a1, any, telenor, vivacom,

Węgry

any,

Mołdawia

any, moldcell, orange, unite,

Włochy

any,

Paragwaj

any,

Honduras

any,

Tunezja

any, ooredoo, orange, tunicell,

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, claro, digi, movistar, red, tigo,

102

Libia

any,

103

Jamajka

any, digi,

104

Trynidad i Tobago

any,

105

Ekwador

any, cnt_mobile, tuenti,

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, nos, 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, ose, 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, claro, movistar,

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, dna,

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,

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

Nazwać

Магнит

Mail.ru

Paxful

Amasia

Microsoft

AliExpress

Tinder

23red

Monobank

Юла

EasyPay

X5ID

Nanovest

Meliuz

Dhani

Huya

Divar

Mercari

Keybase

GoFundMe

E bike Gewinnspiel

Indomaret

Socios

ShellBox

Lenta

myGLO

Grab

HandyPick

LightChat

Yemeksepeti

LYKA

Happn

Mamba

TikTok/Douyin

BIGO LIVE

Tencent QQ

Global24

163СOM

Blizzard

RoyalWin

Ukrnet

Okta

Inboxlv

888casino

NimoTV

GalaxyWin

JKF

Tokopedia

GoogleVoice

Alibaba

TenChat

hamrahaval

Getir

Moneylion

Burger King

Brand20ua

Clubhouse

Bit

Papara

WestStein

Digikala

MyMusicTaste

Whoosh

FoodHub

Fiverr

Siply

Dominos Pizza

dbrUA

IndiaGold

Яндекс

Rediffmail

Wish

KazanExpress

MTS CashBack

DealShare

SpotHit

KFC

CliQQ

cryptocom

Onlinerby

Yahoo

Bilibili

SnappFood

Adidas

AptekaRU

Paytm

kufarby

CafeBazaar

eBay

Wmaraci

Karusel

Taksheel

AliPay

Wolt

Poshmark

СhampionСasino

Dostavista

Вконтакте

Banqi

ZCity

1688

miloan

ChaingeFinance

Weidian

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

Payberry

Magnolia

Urent

Dundle

NoBroker

Ok.ru

Bitaqaty

Pocket52

MPL

SneakersnStuff

Steam

Foodpanda

ЗдравСити

Paysafecard

Tatneft

Potato Chat

YoWin

Bisu

Giftcloud

KeyPay

MyFishka

Ticketmaster

Zilch

Band

Eneba

Agroinform

Drom

Nike

Перекресток

Wise

AOL

Zoho

Банки

Humta

hily

mosru

Fotka

Grindr

LongHu

Airbnb

Dotz

ДругВокруг

Prom

Oriflame

Trip

Alfagift

Paysend

Fiqsy

McDonalds

BlaBlaCar

Imo

Sizeer

OZON

Mylove

OnTaxi

Douyu

99app

AgriDevelop

Line msg

KuCoinPlay

Mailru Group

Wing Money

Noon

Mobile01

Pairs

Столото

Faceit

Gamer

avito

Revolut

Verse

JamesDelivery

Mercado

Coinbase

Amazon

Kotak811

Kaggle

NCsoft

GroupMe

Верный

CourseHero

Powerkredite

SportGully

Foody

Dent

Blued

PingPong

Taikang

Pivko24

TanTan

DewuPoison

Pyro Music

Haraj

Depop

TradingView

Mocospace

ProtonMail

MOMO

WeChat

IPLwin

Fastmail

Weibo

RedBook

LazyPay

Fora

CityBase

Naver

Iwplay

Самокат

facebook

Vivo

GlobalTel

Netflix

CMTcuzdan

Rambler

Truecaller

Wildberries

IFood

BillMill

Careem

ВкусВилл

99acres

Uber

Venmo

Coindcx

YouStar

Onet

Monese

Airtel

Hinge

Wink

Zalo

Twilio

Magicbricks

炙热星河

Lidl

Możliwy błąd

Odpowiedź serwera

Opis

BAD_ACTION

Nieprawidłowe generowanie żądania

BAD_KEY

Nieprawidłowy klucz API

BAD_LANG

Nieprawidłowa lokalizacja, zaakceptowane ru lub en

NO_ACTIVATION

Identyfikator aktywacji nie istnieje

ERROR_SQL

Błąd bazy danych SQL Server

ERROR_API

Błąd przetwarzania