Прийом смс - Документація API | Сервіс прийому смс на тимчасові номери телефонів

Довгострокова оренда номерів Оренда на 20 хвилин Реферальна програма API Служба підтримки

Attention! We have moved to a new domain. If you worked with the API you need to change the domain from the old one to the new one "sms-activation-service.com"

Опис протоколу API
Перевірити баланс

getBalance
Отримати всі країни та операторів доступних для них

getCountryAndOperators
Отримати актуальні ціни та кількість номерів

getServicesAndCost
Get current prices and number of numbers with statistics

getServicesAndCostWithStatistics
Замовлення номера

getNumber
Змінити статус

setStatus
Отримати поточний статус

getStatus
Отримати поточний статус

getCurrentActivationsList
Можливі помилки
Додаток 1. Список країн
Додаток 2. Список сервісів

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

API - це протокол взаємодії між вашим програмним забезпеченням і нашим сервером активацій.

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

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

Увага

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

Useful options for API clients.

Find out in which country the cheapest temporary numbers under X service? "See where the cheapest numbers are."
View the percentage of successful SMS received by other users. "Learn more about SMS deliverability statistics"
Set the maximum purchase price so as not to get a sharp price increase due to high demand "Learn more about how to limit the price of buying numbers."

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

getBalance

Перевірити баланс

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

Поле

Тип

Опис

api_key

string

Ваш API-ключ, забезпечує доступ до оплачених послуг. API-ключ слід зберігати в таємниці

action

string

Назва методу

lang

string

Локалізація ru або en

Відповідь сервера:

Приклад відповіді:

463.02

getCountryAndOperators

Отримати всі країни та операторів доступних для них

https://sms-activation-service.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 країни

name

Росія

Назва країни

operators

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

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

getServicesAndCost

Отримати актуальні ціни та кількість номерів

https://sms-activation-service.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 сервісу

name

Вконтакте

Назва сервісу

price

29.88

Актуальна ціна

quantity

Кількість номерів

getServicesAndCostWithStatistics

Get the current prices and number of numbers with statistics of sms delivery by service/sites and a list of minimum prices by country.

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

Поле

Тип

Опис

api_key

string

Ваш API-ключ, забезпечує доступ до оплачених послуг. API-ключ слід зберігати в таємниці

operator

string

стільниковий оператор номер якого необхідно отримати див. "Список країн"

country

integer

ID Країни номер якої необхідно отримати див. "Список країн"

lang

string

Локалізація ru або en

Відповідь сервера:

Приклад відповіді в JSON:

[{"id":"tg","name":"Telegram","price":0.71,"quantity":1429,"deliverability":"25.82","cheap_prices_countries":[{"country_id":6,"country_name":"Indonesia","price":"0.20"},{"country_id":10,"country_name":"Viet Nam","price":"0.33"},{"country_id":93,"country_name":"Costa Rica","price":"0.36"},{"country_id":57,"country_name":"Iran","price":"0.36"},{"country_id":61,"country_name":"Senegal","price":"0.37"}]]

Поле

Приклад

Опис

ID сервісу

name

Вконтакте

Назва сервісу

price

29.88

Актуальна ціна

quantity

Кількість номерів

deliverability

12.71

Percentage of SMS deliverability by service/site

cheap_prices_countries

{"country_id":6,"country_name":"Indonesia","price":"0.20"}

List of minimum prices by country

getNumber

Замовлення номера

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

Поле

Тип

Опис

api_key

string

Ваш API-ключ, забезпечує доступ до оплачених послуг. API-ключ слід зберігати в таємниці

action

string

Назва методу

service

string

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

operator

string

стільниковий оператор номер якого необхідно отримати див. "Список країн"

country

integer

ID Країни номер якої необхідно отримати див. "Список країн"

lang

string

Локалізація ru або en

Відповідь сервера:

Відповідь сервера

Приклад

Опис

NO_BALANCE

Недостатньо балансу на обліковому записі API

NO_NUMBERS

Немає номерів із заданими параметрами, спробуйте пізніше, або поміняйте оператора, країну.

ACCESS_NUMBER:ID:NUMBER

ACCESS_NUMBER:234242:79991728822

Отримали номер, ID активації - ID, сам номер із кодом країни - NUMBER

setStatus

Змінити статус

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

Поле

Тип

Опис

api_key

string

Ваш API-ключ, забезпечує доступ до оплачених послуг. API-ключ слід зберігати в таємниці

action

string

Назва методу

integer

ID активації, отриманий при запиті номера

status

integer

Статус, який необхідно передати активації

lang

string

Локалізація ru або en

Доступні статуси:

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

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

8 - Скасувати замовлення

Відповідь сервера:

Відповідь сервера

Опис

NO_BALANCE

Недостатньо балансу на обліковому записі API

ACCESS_CANCEL

Активація скасована

ACCESS_RETRY_GET

Чекаємо нове смс

ACCESS_ACTIVATION

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

CANNOT_BEFORE_2_MIN

Не можна скасувати раніше 2 хвилин після замовлення номера

getStatus

Отримати поточний статус

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

Поле

Тип

Опис

api_key

string

Ваш API-ключ, забезпечує доступ до оплачених послуг. API-ключ слід зберігати в таємниці

action

string

Назва методу

integer

ID активації, отриманий при запиті номера

lang

string

Локалізація ru або en

Відповідь сервера:

Відповідь сервера

Опис

STATUS_WAIT_CODE

Чекаємо приходу смс

STATUS_CANCEL

активацію скасовано

STATUS_OK:CODE

Код отриманий (де CODE - код активації)

getCurrentActivationsList

Отримати поточний статус

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

Поле

Тип

Опис

api_key

string

Ваш API-ключ, забезпечує доступ до оплачених послуг. API-ключ слід зберігати в таємниці

action

string

Назва методу

status

integer

Номер статусу за якою фільтруємо (доступно - 0 (новий, очікує смс) | 1 (завершено) | 2 (скасовано) | 3 (отримано смс) | 4 (очікує дод. смс))

order

string

По якому полю сортуємо (доступні - id/number/date)

orderBy

string

Сортуємо за зростанням/зменшенням (ASC/DESC)

lang

string

Локалізація ru або en

Відповідь сервера:

Приклад відповіді в JSON:

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

Можливі помилки

Відповідь сервера

Опис

BAD_ACTION

Неправильне формування запиту

BAD_KEY

Неправильний API-ключ

BAD_LANG

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

NO_ACTIVATION

ID активації не існує

ERROR_SQL

Помилка бази SQL-сервера

ERROR_API

Помилка обробки

REQUEST_LIMIT

Ліміт запитів на секунду

Додаток 1. Список країн

Найменування

Доступні оператори

Росія

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

Україна

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

Казахстан

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

Китай

any, china_unicom, chinamobile, unicom

Філіппіни

any, globe_telecom, smart, tm

М'янма

any, mpt, mytel, ooredoo, telenor

Індонезія

any, axis, indosat, smartfren, telkomsel, three

Малайзія

any, celcom, digi, hotlink, tune_talk, u_mobile, xox, yes

Кенія

airtel, any, econet, orange, safaricom, telkom

Танзанія

airtel, any, halotel, tigo, ttcl, vodacom

В'єтнам

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

Киргизстан

any, beeline, megacom, o!

США (віртуальні)

any, cellular, tmobile

Ізраїль

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

Гонконг (Китай)

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

Польща

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

Англія (UK)

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

Мадагаскар

any

Дем. Конго

africel, airtel, any, orange, vodacom

Нігерія

airtel, any, etisalat, glomobile, mtn

Макао

3macao, any

Єгипет

any, etisalat, orange, vodafone

Індія

any

Ірландія

48mobile, any, cablenet, lycamobile, tesco

Камбоджа

any, metfone

Лаос

any, etl, telekom, tplus, unitel

Гаїті

any, natcom

Кіт д'Івуар

any, moov, mtn, orange

Гамбія

africel, any, comium, gamcel, qcell

Сербія

a1, any, mobtel, mts, vip

Ємен

any, mtn, sabafon, yemen_mobile

ПАР

any, cell_c, lycamobile, mtn, telkom, vodacom

Румунія

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

Колумбія

any, claro, movistar, tigo, virgin, wom

Естонія

any, elisa, goodline, super, tele2, topconnect

Азербайджан

any, azerfon, humans

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

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

Марокко

any, iam, inwi, itissalat, orange

Гана

airtel, any, glomobile, millicom, mtn, vodafone

Аргентина

any, claro, movistar, personal

Узбекистан

any, beeline, humans, mobiuz, mts, ucell, uzmobile

Камерун

any, mtn, nexttel, orange

Чад

airtel, any, salam, tigo

Німеччина

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

Литва

any, bite, tele2, telia

Хорватія

a1, any, tele2, telemach, tmobile, tomato

Швеція

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

Ірак

any, asiacell, korek, zain

Нідерланди

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

Латвія

any, bite, lmt, tele2, xomobile

Австрія

a1, any, eety, hot_mobile, lidl, lycamobile, orange, telering, three, tmobile, yesss

Білорусь

any, best, life, mdc, mts

Таїланд

ais, any, dtac, truemove

Сауд. Аравія

any

Мексика

any, telcel

Тайвань

any, chunghwa, fareast

Іспанія

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

Іран

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

Алжир

any, djezzy, mobilis, ooredoo

Словіння

a1, any, telekom, telemach

Бангладеш

any

Сенегал

any, expresso, free, orange

Туреччина

any, turk_telekom, turkcell

Чехія

any, kaktus, o2, tmobile, vodafone

Шрі-Ланка

airtel, any, dialog, etisalat, hutch, sltmobitel

Перу

any, movistar

Пакистан

any, jazz, ptcl, sco, telenor, ufone, zong

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

2degree, any, one_nz, skinny, vodafone, warehouse

Гвінея

any, cellcom, mtn, orange, sotelgui, telecel

Малі

any, malitel, orange, telecel

Венесуела

any

Ефіопія

any, mtn

Монголія

any, beeline

Бразилія

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

Афганістан

any, salaam

Уганда

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

Ангола

africel, any, unitel

Кіпр

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

Франція

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

Нова Гвінея

any

Мозамбік

any

Непал

any

Бельгія

any, bandwidth, base, infrabel, lycamobile, nethys, orange, proximus, vectone

Болгарія

a1, any, telenor, vivacom, yettel

Угорщина

any, tmobile, vodafone, yettel

Молдова

any, idc, moldcell, orange, unite

Італія

any, ho, kena_mobile, lycamobile, optima, tim, vodafone, wind

Парагвай

any, claro, personal

Гондурас

any, claro

Туніс

any, ooredoo, orange, tunicell

Нікарагуа

any, movistar

Тімор-Лесте

any, telemor, telkomcel, timor_telecom

Болівія

any

Коста Ріка

any

Гватемала

any, claro, movistar, tigo

ОАЕ

any

Зімбабве

any, econet

Пуерто-Ріко

any

Судан

any, mtn, sudani_one, zain

Того

any

100

Кувейт

any

101

Сальвадор

any, claro, digi, movistar, red, tigo

102

Лівія

any

103

Ямайка

any, digi

104

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

any

105

Еквадор

any, claro, cnt_mobile, movistar, tuenti

106

Свазіленд

any

107

Оман

any

108

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

a1, any, hej

109

Домініканська Республіка

altice, any, claro, viva

111

Катар

any

112

Панама

any

113

Куба

any, cubacel

114

Мавританія

any, chinguitel, mattel, mauritel

115

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

africel, airtel, any, qcell

116

Йорданія

any, orange, umniah, xpress, zain

117

Португалія

any, lebara, lycamobile, nos, vodafone

118

Барбадос

any

119

Бурунді

africel, any, econet, lacell, telecel, viettel

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

Руанда

airtel, any, mtn

141

Словаччина

any, o2

142

Суринам

any

143

Таджикистан

any, indigo

144

Монако

any

145

Бахрейн

any

146

Реюньйон

any

147

Замбія

airtel, any, mtn, zamtel

148

Вірменія

any, team, viva, vivo

149

Сомалі

any

150

Конго

airtel, any

151

Чилі

any, claro, entel, movistar, wom

152

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

airtel, any, onatel, telecel

153

Ліван

alfa, any, ogero, touch

154

Габон

any

155

Албанія

any, telekom, vodafone

156

Уругвай

any, claro

157

Маврикій

any

158

Бутан

any

159

Мальдіви

any

160

Гваделупа

any

161

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

any

162

Французька Гвіана

any

163

Фінляндія

any, dna, elisa, telia

164

Сент-Люсія

any

165

Люксембург

any, tango, tiptop

166

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

any

167

Екваторіальна Гвінея

any

168

Джибуті

any

169

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

any

170

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

any

171

Чорногорія

any

172

Данія

any, lebara, lycamobile

173

Швейцарія

any

174

Норвегія

any, my_call, telia

175

Австралія

any, optus, telstra, vodafone

176

Еритрея

any

177

Південний Судан

any, mtn, zain

178

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

any

179

Аруба

any

180

Монтсеррат

any

181

Ангілья

any

183

Північна Македонія

a1, any, lycamobile, telekom, vip

184

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

any

185

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

any

186

Кабо-Верде

any

187

США (Реальні)

any, at_t, lycamobile, tmobile

189

Фіджі

any

196

Сінгапур

any, maxx, simba, singtel, starhub

Додаток 2. Список сервісів

№

Найменування

Instagram

Facebook

Google,youtube,Gmail

Twitter

Microsoft

Alipay/Alibaba

Amazon

Tinder

Mail.ru (Майл.ру)

Discord

Steam

Indomaret

TikTok/Douyin

Line msg

Not on list

Urent/jet/RuSharing

MTS CashBack (МТС Кешбек)

Naver

ChatGPT (openAI.com)

Vkontakte(vk.ru)

Nike

Yahoo

Яндекс (Yandex)

EBay

AOL

WinzoGame

PayPal

Lazada

Однокласники (ok.ru)

Shopee

Avito

Foodpanda

Uber

99app

Wildberries

WeChat

Grindr

acz

Claude

Signal

Viber

Tokopedia

KakaoTalk

99acres

OLX

Vinted

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

Букмекерские (Betting)

Pof.com

RedBook

888casino

Apple

Yalla

Zalo

Snapchat

DiDi

IFood

Gojek

OVO

OkCupid

Dana

СберМаркет

Happn

РСА

GCash

Grab

Fruitz

МВидео

Imo

Casino/bet/gambling

GoogleVoice

OZON

act

Maxis

Olacabs

Hinge

Netflix

Mercado

Bumble

Venmo

Blizzard

MotorkuX

Airbnb

PGbonus

Metro

Leboncoin

Bazos

Pinduoduo

TanTan

DoorDash

Picpay

ado

SmartyPig

Hepsiburadacom

Weibo

Bolt

acp

BonusLink

Tencent QQ

Wolt

Uklon

100

aav

Alchemy

101

Miravia

102

Bet365

103

acy

Airtime

104

MobiKwik

105

Temu

106

Oldubil

107

ZéDelivery

108

Deliveroo

109

Delivery Club

110

acb

Spark Driver

111

Clubhouse

112

Lyft

113

EscapeFromTarkov

114

Ticketmaster

115

Iti

116

MPL

117

abx

Kaching

118

abk

GMX

119

Shpock

120

Justdating

121

ada

TRUTH SOCIAL

122

Эльдорадо

123

FreeNow

124

Carousell

125

Immowelt

126

Badoo

127

Careem

128

Ukrnet

129

Mamba

130

BigC

131

Asda

132

BLIBLI

133

aaa

Nubank

134

Lenta

135

Xiaomi

136

BlaBlaCar

137

Depop

138

Юла

139

Alfagift

140

YAPPY

141

Payoneer

142

Лэтуаль

143

Самокат

144

Магнит

145

Sravni

146

abq

Upwork

147

abt

ArenaPlus

148

Kolesa.kz

149

Paytm

150

AIS

151

aec

JinJiang

152

Bilibili

153

DewuPoison

154

MyGLO

155

acc

LuckyLand Slots

156

JDcom

157

СпортМастер

158

Fora

159

adc

PlayOJO

160

AliExpress

161

Betfair

162

Zoho

163

Kaggle

164

X5ID

165

SoulApp

166

Beget

167

Santander

168

Faceit

169

Freelancer

170

BIGO LIVE

171

MarketGuru

172

ShellBox

173

KFC

174

AVON

175

InDriver

176

Subito

177

Wise

178

Perfluence

179

Swiggy

180

abl

Gpnbonus

181

ЗдравСити

182

Craigslist

183

Onet

184

Rozetka

185

Astropay

186

Hopi

187

Prom

188

Linode

189

Truecaller

190

Zdorov

191

Hily

192

acn

Radium

193

RecargaPay

194

Paysafecard

195

AptekaRU

196

FunPay

197

acj

Meituan

198

Baidu

199

Zupee

200

Neftm

201

abc

Taptap Send

202

Fiverr

203

Wink

204

ВкусВилл

205

YoWin

206

Zhihu

207

Twitch

208

Vivo

209

Myntra

210

Kwai

211

abn

Namars

212

ProtonMail

213

Coinbase

214

Hotline

215

Skype

216

ZCity

217

EWallet

218

Rediffmail

219

ZaleyCash

220

JTExpress

221

WestStein

222