Прием смс - Документация API | Cервис приема смс на временные номера телефонов

Внимание! Мы переехали на новый домен.
Если вы работали с API вам нужно заменить домен со старого на новый "sms-activation-service.com"

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

getBalance
Получить все страны и операторов доступных для них

getCountryAndOperators
Получить актуальные цены и количество номеров

getServicesAndCost
Заказ номера

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". Ограничения RPS - 8 запросов в секунду.

Полезные опции для клиентов работающих с API.

Как узнать в какой стране самые дешевые временные номера под X сервис? "Посмотреть где самые дешевые номера."
Как посмотреть % успешного получения смс по другим пользователям. "Узнать подробнее о статистике доставляемости смс"
Поставить максимальную цену на покупку чтобы не попадать резкое повышение цены из-за высокого спроса "Узнать подробнее как ограничить цену на покупку номеров. "

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

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

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 } ]

Приложение 1. Список стран

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

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

Россия

aiva, any, beeline, center2m, danycom, ezmobile, gazprombank_mobile, lycamobile, matrix, 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

Кения

airtel, any, econet, orange, safaricom, telkom

Танзания

airtel, any, halotel, tigo, ttcl, vodacom

Вьетнам

any, itelecom, mobifone, vietnamobile, viettel, vinaphone

Кыргызстан

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

Польша

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

Узбекистан

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

Пакистан

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

Боливия

any

Коста Рика

any

Гватемала

any, claro, movistar, tigo

ОАЭ

any

Зимбабве

any, econet

Пуэрто-Рико

any

Того

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

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, viva, vivo

149

Сомали

any

150

Конго

airtel, any

151

Чили

any, claro, entel, movistar

152

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

airtel, any, onatel, telecel

153

Ливан

alfa, any, ogero, touch

154

Габон

any

155

Албания

any, telekom, vodafone

156

Уругвай

any

157

Маврикий

any

158

Бутан

any

159

Мальдивы

any

160

Гваделупа

any

161

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

any

162

Французская Гвиана

any

163

Финляндия

any, dna, elisa, telia

164

Сент-Люсия

any

165

Люксембург

any

166

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

any

167

Экваториальная Гвинея

any

168

Джибути

any

169

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

any

170

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

any

171

Черногория

any

172

Дания

any, lebara, lycamobile

173

Швейцария

any

174

Норвегия

any

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

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

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

IndianOil

Dana

AIS

OkCupid

Pairs

Yahoo

MoneyPay

TurkiyePetrolleri

勇仕网络Ys4fun

AOL

Dostavista

NRJ Music Awards

Около

Brand20ua

Mewt

Вконтакте (vk.ru)

LoveRu

AptekaRU

Максавит

Brahma

Pocket52

Socios

Dosi

BlaBlaCar

Wmaraci

Праймериз 2020

AptekiPlus

KakaoTalk

TradeUP

Самокат

CashKaro

InDriver

Gittigidiyor

MOMO

GuruBets

Santander

Детский мир

Alfagift

CloudChat

Ininal

YandexGo

Consultant

Эльдорадо

Giftcloud

EFood

Avito

OnTaxi

Papara

MyMusicTaste

Virgo

Quipp

OfferUp

Seosprint

Bumble

Skout

Paysend

ROBINHOOD

Twilio

BLIBLI

Iti

СберАптека

RummyLoot

Asda

BIGO LIVE

CommunityGaming

MIYACHAT

Paysafecard

HQ Trivia

Paytm

LYKA

Zalo

Chispa

XadrezFeliz

Perfluence

Oriflame

ChatGPT (openAI.com)

Porbet

TeenPattiStarpro

4Fun

MarketGuru

SamsungShop

Badoo

Starbucks

RedBus

DoorDash

SneakersnStuff

Coindcx

YoWin

Digikala

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

NoBroker

Quack

GyFTR

Uklon

CELEBe

LightChat

Юла

HOP

HandyPick

PharmEasy

AliExpress

Taikang

Bolt

MapleSEA

99app

Fiqsy

CDkeys

Surveytime

Rambler

Taki

LigaPro

Line msg

Urent

Things

MarketPapa

Faberlic

Disney Hotstar

Voltz

FoxFord

MyDailyCash

Hopi

Mocospace

IQIYI

Nttgame

Nextdoor

Skroutz

Voggt

Potato Chat

Microsoft

Zomato

Yemeksepeti

ЗдравСити

PingPong

Gett

Hamrahaval

Taksheel

Rediffmail

Mylove

Humblebundle

Whoosh

Верный

Powerkredite

Blizzard

Leboncoin1

Siply

Coinbase

Trendyol

Facebook

Author24

Ticketmaster

Parkplus

Magnolia

Qoo10

Uber

Kufarby

Instagram

Ace2Three

GCash

Ukrnet

Gamekit

LOCO

Nike

Twitter

McDonalds

Bazos

DewuPoison

Linode

Imo

Idealista

Indomaret

Vidio

Onet

Mzadqatar

Tick

1хbet

CashApp

Fora

LiveScore

AVON

Tencent QQ

Окей

IceCasino

MPL

IVI

My11Circle

PingCode

ВкусВилл

Noon

WestStein

Sizeer

KeyPay

Pyro Music

Paxful

Fruitz

UU163

Перекресток

Ximalaya

OZON

MonobankIndia

GalaxyWin

CoinField

Airtel

TikTok/Douyin

Fiverr

Megogo

IndiaGold

PGbonus

Lidl

Huya

Bit

Sorare

Kotak811

MediBuddy

Yalla

Freelancer

Douyu

HappyFresh

HeyBox

YikYak

Loanflix

Alfa

Mobile01

Icrypex

Allegro

MobiKwik

Olacabs

Tinder

Global24

Stripe

KFC

23red

Naver

MIRATORG (Мираторг)

GameArena

Dominos Pizza

WinzoGame

BLS-SPAIN

TopDetal

Dundle

LazyPay

Craigslist

Budget4me

1688

Zdorov

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

Weverse

Agroinform

GiraBank

Ruten

TenChat

Kaggle

Divar

Deliveroo

Lalamove

Foodpanda

FreshKarta

Venmo

Neftm

JungleeRummy

Vlife

Weibo

Switips

Glovo

Hermes

MyLavash

KazanExpress

EBay

Wink

Лейка

Netflix

Магнит

YouStar

IFood

Gojek

Delivery Club

RosaKhutor

MoneyСontrol

Hezzl

Lotus

Wildberries

Rbt

Mosru

JamesDelivery

Cryptocom

ChaingeFinance

CourseHero

JKF

Kolesa.kz

LUKOIL-AZS

CMTcuzdan

Rozetka

Aitu

Viber

Lazada

888casino

Myntra

Pivko24

Swiggy

SnappFood

CloudBet

E bike Gewinnspiel

Getmega

Лэтуаль

Bet365

Trip

FotoCasa

Dent

Clubhouse

Uplay

Prom

Meliuz

MEGA

Magicbricks

ContactSys

EasyPay

Энергобум

Payzapp

UWIN

AGIBANK

СпортМастер

SpotHit

TanTan

AdaKami

Pof.com

Flink

EWallet

Humta

Nifty

Skype

Домовой

RummyWealth

Adani

Onlinerby

GMNG

Iwplay

Rush

NovaPoshta

Grindr

Immowelt

FWDMAX

Burger King

Uteka

PaddyPower

NimoTV

Yubo

Mamba

RedBook

Blued

Celcoin

CAIXA

GalaxyChat

CliQQ

CrefisaMais

Vivo

Gabi

Crowdtap

Akulaku

Sravni

КухняНаРайоне

FreeChargeApp

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

WorldRemit

Контур

Getir

Cleartrip

Irancell

Штолле

Hily

Astropay

Swvl

CashFly

Discord

Akudo

RuTube

IZI

Joyride

Happn

Verse

Poshmark

Twitch

Stormgain

ZCity

Mercari

СhampionСasino

Apple

Wing Money

JTExpress

GlobalTel

Damejidlo

Premium.one

Hirect

Inboxlv

A9A

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

Zhihu

Ашан

GoFundMe

InFund

CityBase

Payoneer

Monese

Potato

Голос

Hepsiburadacom

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

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

Описание

BAD_ACTION

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

BAD_KEY

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

BAD_LANG

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

NO_ACTIVATION

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

ERROR_SQL

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

ERROR_API

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