API - это протокол взаимодействия между вашим ПО и нашим сервисом активаций. Он необходим для автоматизации процесса получения СМС на вашей стороне.
Все запросы (POST или GET) должны идти на данный адрес:
https://365sms.org/stubs/handler_api.php
Если вы являетесь разработчиком софта, то вам достаточно поменять адрес сайта в коде на https://365sms.org/
Наш протокол полностью совместим с сервисом sms-activate. Для подмены хоста добавьте в файл hosts C:\Windows\System32\drivers\etc\ следующую строчку:
46.36.219.142 sms-activate.ru
Во избежание ошибки протокола HTTPS, отправляйте запросы без HTTPS, используя HTTP. Каждый запрос должен содержать API-ключ в виде параметра "api_key".
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getNumbersStatus&country=COUNTRY&operator=OPERATOR
| Параметр | Принимаемые значения | Обязательность | Описание |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Да | Ваш API-ключ, обеспечивает доступ к оплаченным услугам |
| COUNTRY | См. список стран внизу страницы | Да | Страна номера |
| OPERATOR | Список доступных операторов можно найти внизу страницы | Нет | Оператор номера. Если параметр не задан, то будет задействован последний выбранный оператор |
Ответ сервиса будет в json формате, пример:
{"vk_0":890,"ok_0":192,"wa_0":146,"vi_0":199,"tg_0":101,"wb_0":103,"go_0":467,"av_0":177,"fb_0":132,"tw_0":479}
До нижнего подчерквания - название сервиса. После - обзоначение о включении/выключении переадресации.
0 - не включать
1 - включать
Номеров с переадресацией мы пока не предоставляем.
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getBalance
| Параметр | Принимаемые значения | Обязательность | Описание |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Да | Ваш API-ключ, обеспечивает доступ к оплаченным услугам |
| Ответ сервера | Пример | Описание |
|---|---|---|
| ACCESS_BALANCE:BALANCE | ACCESS_BALANCE:540 | BALANCE - баланс вашего акаунта |
| Ответ сервера | Описание |
|---|---|
| BAD_KEY | Неверный API-ключ |
| ERROR_SQL | Ошибка SQL-сервера |
| BAD_ACTION | Неправильное формирование запроса |
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getNumber&service=SERVICE&operator=OPERATOR&country=COUNTRY
| Параметр | Принимаемые значения | Обязательность | Описание |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Да | Ваш API-ключ, обеспечивает доступ к оплаченным услугам. API-ключ следует хранить в тайне |
| SERVICE | См. список сервисов внизу страницы | Да | Сервис, номер для которого необходимо получить |
| OPERATOR | Принимаемые параметры зависят от конкретной страны. Для уточнения обратите внимание на таблицу внизу страницы | Нет | Сотовый оператор. номер которого необходимо получить |
| COUNTRY | Да | Страна, номер которой необходимо получить |
| Ответ сервера | Пример | Описание |
|---|---|---|
| NO_NUMBERS | NO_NUMBERS | Нет номеров с заданными параметрами, попробуйте позже, или поменяйте оператора, страну |
| NO_BALANCE | NO_BALANCE | Закончились деньги на аккаунте |
| WRONG_SERVICE | WRONG_SERVICE | Не верный идентификатор сервиса |
| ACCESS_NUMBER:ID:NUMBER | ACCESS_NUMBER:234242:79123456789 | Получили номер, ID активации - ID, сам номер с кодом страны - NUMBER |
| Ответ сервера | Описание |
|---|---|
| BAD_ACTION | Неправильное формирование запроса |
| BAD_SERVICE | Некорректное наименование сервиса |
| BAD_KEY | Неверный API-ключ |
| ERROR_SQL | Ошибка базы SQL-сервера |
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=setStatus&status=STATUS&id=ID
| Параметр | Принимаемые значения | Обязательность | Описание |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Да | Ваш API-ключ обеспечивает доступ к оплаченным услугам |
| ID | Числовое значение | Да | ID активации, полученное при запросе номера |
| STATUS | 1 - смс на номер отправлено, 3 - необходимо повторно смс, 6 - активация успешно завершена, 8 - отменить активацию |
Да | Статус который необходимо передать активации |
Какой статус когда отправлять?
Простая логика взаимодействия с API
Сразу после получения номера доступны следующие действия:
8 - Отменить активацию
1 - Сообщить, что SMS отправлена (необязательно)
Для активации со статусом 1:
8 - Отменить активацию
Сразу после получения кода:
3 - Запросить еще одну смс
6 - Подтвердить SMS-код и завершить активацию
Для активации со статусом 3:
6 - Подтвердить SMS-код и завершить активацию
| Ответ сервера | Описание |
|---|---|
| ACCESS_READY | Готовность ожидания СМС |
| ACCESS_RETRY_GET | Ожидаем новое СМС |
| ACCESS_ACTIVATION | Активация успешно завершена |
| ACCESS_CANCEL | Активация отменена |
| Ответ сервера | Описание |
|---|---|
| BAD_ACTION | Общее неправильное формирование запроса |
| BAD_SERVICE | Некорректное наименование сервиса |
| BAD_KEY | Неверный API-ключ |
| NO_ACTIVATION | id активации не существует |
| ERROR_SQL | Ошибка базы SQL-сервера, обратитесь к администратору |
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getStatus&id=ID
| Параметр | Принимаемые значения | Обязательность | Описание |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Да | Ваш API-ключ обеспечивает доступ к оплаченным услугам |
| ID | Числовое значение | Да | ID активации, полученное при запросе номера |
| Ответ сервера | Описание |
|---|---|
| STATUS_WAIT_CODE | Ожидаем прихода СМС |
| STATUS_WAIT_RETRY:LASTCODE | Ожидаем повторное СМС. LASTCODE - последнее полученное СМС |
| STATUS_CANCEL | Активация отменена |
| STATUS_OK:CODE | Код получен (где CODE - код активации) |
| Ответ сервера | Описание |
|---|---|
| BAD_ACTION | Общее неправильное формирование запроса |
| BAD_KEY | Неверный API-ключ |
| NO_ACTIVATION | ID активации не существует |
| ERROR_SQL | Ошибка базы SQL-сервера. Обратитесь к администратору |
https://365sms.org/stubs/handler_api.php?api_key=APIKEY&action=getPrices&service=SERVICE&country=COUNTRY
| Параметр | Принимаемые значения | Обязательность | Описание |
|---|---|---|---|
| APIKEY | yo3bPrzepLDAgcU7bFwfvmrvYalMGA | Да | Ваш API-ключ, обеспечивает доступ к оплаченным услугам. API-ключ следует хранить в тайне |
| SERVICE | См. список сервисов внизу страницы | Нет | Сервис, номер для которого необходимо получить |
| COUNTRY | См. список стран внизу страницы | Да | Страна номера |
| Ответ сервера | Описание |
|---|---|
| JSON ответ | Ответ в формате { "Страна": { "Сервис": { "Цена": Количество}}} |
| ID | Наименование | Доступные операторы |
|---|---|---|
| 0 | Россия | aiva, any, beeline, center2m, danycom, ezmobile, lycamobile, matrix, megafon, motiv, mts, mtt, rostelecom, sber, simsim, tele2, tinkoff, ttk, winmobile, yota |
| 1 | Украина | 3mob, any, intertelecom, kyivstar, life, lycamobile, mts, utel, vodafone |
| 2 | Казахстан | activ, altel, any, beeline, tele2 |
| 3 | Китай | any, chinamobile, unicom |
| 4 | Филиппины | any, globe_telecom, tm |
| 5 | Мьянма | any, telenor |
| 6 | Индонезия | any, axis, indosat, telkomsel, threeuk |
| 7 | Малайзия | any, digi, hotlink, u_mobile |
| 8 | Кения | airtel, any, econet, orange, safaricom, telkom |
| 10 | Вьетнам | any, itelecom, mobifone, vietnamobile, viettel, vinaphone |
| 11 | Кыргызстан | any, beeline, megacom, o! |
| 12 | США (виртуальные) | any, cellular, tmobile |
| 13 | Израиль | any, orange, pelephone |
| 15 | Польша | any, klucz, orange, play, plus, tmobile |
| 16 | Англия | any, cmlink, ee, ezmobile, lebara, lycamobile, o2, talk_telecom, threeuk, tmobile, vodafone |
| 18 | Дем.Конго | africel, airtel, any, orange, vodacom |
| 19 | Нигерия | airtel, any, etisalat, glomobile, mtn |
| 21 | Египет | any, etisalat, orange, vodafone |
| 22 | Индия | any |
| 23 | Ирландия | any, lycamobile |
| 24 | Камбоджа | any |
| 25 | Лаос | any, etl, telekom, tplus, unitel |
| 26 | Гаити | any, natcom |
| 27 | Кот д'Ивуар | any, moov, mtn, orange |
| 28 | Гамбия | africel, any, comium, gamcel, qcell |
| 29 | Сербия | any, mobtel, mts, vip |
| 30 | Йемен | any, mtn, sabafon, yemen_mobile |
| 31 | Южная Африка | any, vodacom |
| 32 | Румыния | any, digi, lycamobile, orange, telekom, vodafone |
| 33 | Колумбия | any |
| 34 | Эстония | any, elisa, goodline, super, tele2, topconnect |
| 36 | Канада | any, cellular, lucky |
| 37 | Марокко | any, inwi, itissalat, orange |
| 38 | Гана | airtel, any, glomobile, millicom, mtn, vodafone |
| 39 | Аргентина | any |
| 40 | Узбекистан | any, beeline, mts, ucell, uzmobile |
| 41 | Камерун | any, mtn, nexttel, orange |
| 42 | Чад | airtel, any, salam, tigo |
| 43 | Германия | any, fonic, lebara, lycamobile, o2, ortel_mobile, vodafone |
| 44 | Литва | any, tele2, telia |
| 45 | Хорватия | any |
| 46 | Швеция | any, comviq, lycamobile, tele2 |
| 47 | Ирак | any, asiacell, korek |
| 48 | Нидерланды | any, lebara, lycamobile |
| 49 | Латвия | any, tele2 |
| 50 | Австрия | any |
| 51 | Беларусь | any, life, mdc, mts |
| 52 | Таиланд | ais, any, truemove |
| 53 | Сауд. Аравия | any |
| 54 | Мексика | any |
| 55 | Тайвань | any, chunghwa, fareast |
| 56 | Испания | any, lebara, lycamobile |
| 57 | Иран | any, aptel, azartel, hamrah_e_aval, irancell, rightel, samantel, shatel, taliya |
| 58 | Алжир | any |
| 60 | Бангладеш | any |
| 61 | Сенегал | any |
| 63 | Чехия | any, o2, tmobile |
| 65 | Перу | any |
| 66 | Пакистан | any |
| 68 | Гвинея | any, cellcom, mtn, orange |
| 69 | Мали | any, malitel, telecel |
| 70 | Венесуэла | any |
| 72 | Монголия | any, beeline |
| 73 | Бразилия | algartelecom, any, claro, correios_celular, oi, tim, vivo |
| 74 | Афганистан | any |
| 75 | Уганда | airtel, any |
| 76 | Ангола | any |
| 77 | Кипр | any |
| 78 | Франция | any, lebara, lycamobile, sfr, syma_mobile, vectone |
| 79 | Папуа-Новая Гвинея | any |
| 80 | Мозамбик | any |
| 81 | Непал | any |
| 85 | Молдова | any, moldcell, orange, unite |
| 87 | Парагвай | any |
| 88 | Гондурас | any |
| 89 | Тунис | any |
| 90 | Никарагуа | any |
| 92 | Боливия | any |
| 94 | Гватемала | any |
| 95 | ОАЭ | any |
| 96 | Зимбабве | any |
| 101 | Сальвадор | any |
| 102 | Ливия | any |
| 103 | Ямайка | any |
| 104 | Тринидад и Тобаго | any |
| 105 | Эквадор | any |
| 109 | Доминиканская Республика | altice, any, claro |
| 114 | Мавритания | any |
| 115 | Сьерра-Леоне | africel, airtel, any |
| 117 | Португалия | any |
| 120 | Бенин | any |
| 121 | Бруней | any |
| 123 | Ботсвана | any |
| 126 | Доминика | any |
| 129 | Греция | any, cosmote, q_telecom, vodafone |
| 131 | Гайана | any |
| 135 | Либерия | any, cellcom, comium, libercell, libtelco, lonestar |
| 142 | Суринам | any |
| 143 | Таджикистан | any |
| 146 | Реюньон | any |
| 148 | Армения | any |
| 150 | Конго | any |
| 152 | Буркина-Фасо | airtel, any, onatel, telecel |
| 153 | Ливан | any |
| 154 | Габон | any |
| 158 | Бутан | any |
| 159 | Мальдивы | any |
| 161 | Туркменистан | any |
| 179 | Аруба | any |
| 187 | США | any, lycamobile, tmobile |
| 195 | Бермуды | any |
| ID | Наименование |
|---|---|
| Вконтакте | vk |
| Ok.ru | ok |
| wa | |
| Viber | vi |
| Telegram | tg |
| wb | |
| Google,youtube,Gmail | go |
| avito | av |
| fb | |
| tw | |
| Uber | ub |
| Gett | gt |
| OLX | sn |
| ig | |
| Hezzl | ss |
| Юла | ym |
| Mail.ru | ma |
| Microsoft | mm |
| Airbnb | uk |
| Line msg | me |
| Yahoo | mb |
| ДругВокруг | we |
| X5ID | bd |
| HQ Trivia | kp |
| Delivery Club | dt |
| Яндекс | ya |
| Steam | mt |
| Tinder | oi |
| Mamba | fd |
| Dent | zz |
| KakaoTalk | kt |
| AOL | pm |
| tn | |
| Tencent QQ | |
| Магнит | mg |
| pof.com | pf |
| Yalla | yl |
| kolesa.kz | kl |
| premium.one | po |
| Naver | nv |
| Netflix | nf |
| icq | iq |
| Onlinerby | ob |
| kufarby | kb |
| Imo | im |
| Michat | mc |
| Discord | ds |
| Seosprint | vv |
| Monobank | ji |
| TikTok/Douyin | lf |
| Ukrnet | hu |
| Skout | wg |
| EasyPay | rz |
| Q12 Trivia | vf |
| Pyro Music | ny |
| Wolt | rr |
| CliQQ | fe |
| ssoidnet | la |
| Zoho | zh |
| Ticketmaster | gp |
| Amazon | am |
| Olacabs | ly |
| Rambler | tc |
| ProtonMail | dp |
| NRJ Music Awards | pg |
| Citymobil/Urent | yf |
| MIRATORG | op |
| PGbonus | fx |
| MEGA | qr |
| СпортМастер | yk |
| Careem | ls |
| BIGO LIVE | bl |
| MyMusicTaste | mu |
| Snapchat | fu |
| Keybase | bf |
| OZON | sg |
| Wildberries | uu |
| BlaBlaCar | ua |
| Alibaba | ab |
| Inboxlv | iv |
| Nttgame | zy |
| Surveytime | gd |
| Mylove | fy |
| mosru | ce |
| Truecaller | tl |
| Globus | hm |
| Bolt | tx |
| Shopee | ka |
| Перекресток | pl |
| Burger King | ip |
| Prom | cm |
| AliPay | hw |
| Karusel | de |
| IVI | jc |
| inDriver | rl |
| Happn | df |
| RuTube | ui |
| Magnolia | up |
| Foodpanda | nz |
| kf | |
| BillMill | ri |
| Quipp | cc |
| Okta | lr |
| JDcom | za |
| MTS CashBack | da |
| Fiqsy | ug |
| KuCoinPlay | sq |
| Papara | zr |
| Wish | xv |
| Icrypex | cx |
| PaddyPower | cw |
| Baidu | li |
| Dominos Pizza | dz |
| paycell | xz |
| Lenta | rd |
| Payberry | qb |
| Drom | hz |
| GlobalTel | gl |
| Deliveroo | zk |
| Socios | ia |
| Wmaraci | xl |
| Yemeksepeti | yi |
| Nike | ew |
| myGLO | ae |
| YouStar | gb |
| РСА | cy |
| RosaKhutor | qm |
| eBay | dh |
| Квартплата+ | yb |
| GG | qe |
| Grindr | yw |
| OffGamers | uz |
| Hepsiburadacom | gx |
| Coinbase | re |
| dbrUA | tj |
| PayPal | ts |
| hily | rt |
| SneakersnStuff | sf |
| Dostavista | sv |
| 23red | qi |
| Blizzard | bz |
| ezbuy | db |
| CoinField | vw |
| Airtel | zl |
| YandexGo | wf |
| MrGreen | lw |
| Rediffmail | co |
| miloan | ey |
| Paytm | ge |
| Dhani | os |
| CMTcuzdan | ql |
| Mercado | cq |
| DiDi | xk |
| Monese | py |
| Kotak811 | rv |
| Hopi | jl |
| Trendyol | pr |
| Justdating | pu |
| Pairs | dk |
| Touchance | fm |
| SnappFood | ph |
| NCsoft | sw |
| Tosla | nr |
| Ininal | hy |
| Paysend | tr |
| CDkeys | pq |
| AVON | ff |
| dodopizza | sd |
| McDonalds | ry |
| E bike Gewinnspiel | le |
| JKF | hr |
| MyFishka | qa |
| Craigslist | wc |
| Foody | kw |
| Grab | jg |
| Zalo | mj |
| LiveScore | eu |
| 888casino | ll |
| Gamer | ed |
| Huya | pp |
| WestStein | th |
| Tango | xr |
| Global24 | iz |
| МВидео | tk |
| Sheerid | rx |
| 99app | ki |
| CAIXA | my |
| OfferUp | zm |
| Swvl | tq |
| Haraj | au |
| Taksheel | ei |
| hamrahaval | rp |
| Gamekit | pa |
| Şikayet var | fs |
| Getir | ul |
| irancell | cf |
| Alfa | bt |
| Disney Hotstar | ud |
| Agroinform | qu |
| humblebundle | un |
| Faberlic | rm |
| CafeBazaar | uo |
| cryptocom | ti |
| Gittigidiyor | nk |
| mzadqatar | jm |
| Algida | lp |
| Cita Previa | si |
| Potato Chat | fj |
| Bitaqaty | pt |
| Праймериз 2020 | qc |
| Amasia | yo |
| Dream11 | ve |
| Oriflame | qh |
| Bykea | iu |
| Immowelt | ib |
| Digikala | zv |
| Wing Money | jb |
| Yaay | vn |
| GameArena | wn |
| Вита экспресс | bj |
| Auchan | st |
| Picpay | ev |
| Blued | qn |
| SpotHit | cd |
| Brand20ua | vo |
| IQOS | il |
| Powerkredite | dx |
| Bisu | el |
| Paxful | dn |
| PurePlatfrom | lk |
| Banqi | vc |
| 1хbet | wj |
| Mobile01 | wk |
| Aitu | jj |
| Adidas | an |
| Самокат | jr |
| Верный | nb |
| Humta | gv |
| Divar | dw |
| Carousell | gj |
| MOMO | hc |
| Eneba | uf |
| Verse | kn |
| Taobao | qd |
| 1688 | hn |
| OnTaxi | zf |
| Hotline | gi |
| Tatneft | uc |
| RRSA | mn |
| Douyu | ak |
| Uklon | cp |
| Moneylion | qo |
| Apple | wx |
| Clubhouse | et |
| Nifty | px |
| PingPong | jh |
| Mailru Group | lb |
| BitClout | lt |
| Skroutz | sk |
| MapleSEA | oh |
| Rozetka | km |
| GalaxyWin | af |
| Ziglu | tt |
| Likee | jf |
| CityBase | az |
| Allegro | yn |
| YouGotaGift | wl |
| Lazada | dl |
| TradingView | gc |
| Fiverr | cn |
| Gabi | ou |
| Kwai | vp |
| Детский мир | rj |
| Yubo | uh |
| iQIYI | es |
| СберМегаМаркет | be |
| Glovo | aq |
| IFood | pd |
| Quack | zw |
| Mocospace | gm |
| Dundle | fi |
| Switips | hg |
| Faceit | qz |
| LYKA | gz |
| Paysafecard | jq |
| Onet | ue |
| LightChat | xf |
| GoFundMe | bp |
| Meta | vy |
| JamesDelivery | ea |
| Столото | hj |
| ВкусВилл | sh |
| ShellBox | vg |
| RedBook | qf |
| Trip | nq |
| BIP | ww |
| Эльдорадо | ke |
| Whoosh | qj |
| KazanExpress | ol |
| Akulaku | tm |
| KeyPay | ra |
| СберМаркет | xj |
| Betfair | vd |
| Gojek | ni |
| Fastmail | mr |
| AliExpress | hx |
| Metro | bv |
| HandyPick | sj |
| ChaingeFinance | td |
| Iwplay | dm |
| GroupMe | xs |
| NimoTV | kz |
| Stripe | nu |
| Eyecon | kr |
| Lidl | pz |
| Twitch | hb |
| GalaxyChat | xe |
| ЗдравСити | io |
| Iti | ad |
| Setel | zg |
| Revolut | ij |
| СберАптека | sl |
| 163СOM | wp |
| Hermes | en |
| Kaggle | zo |
| HeyBox | vx |
| Band | hl |
| Potato | lq |
| СhampionСasino | uj |
| Roposo | ga |
| Wise | bo |
| KFC | fz |
| OkCupid | vm |
| Pocket52 | ch |
| Payzapp | yp |
| AgriDevelop | cs |
| CourseHero | yg |
| Santander | lj |
| Poshmark | oz |
| TanTan | wh |
| IZI | wt |
| Okko | og |
| MPL | xq |
| OVO | xh |
| Vinted | kc |
| 4Fun | hk |
| Около | yz |
| Sizeer | eo |
| Букмекерские конторы | ft |
| Noon | tf |
| Megogo | lv |
| Zomato | dy |
| DewuPoison | lx |
| Giftcloud | nn |
| Bilibili | zs |
| Vivo | kx |
| Twilio | ee |
| IndiaGold | tp |
| RoyalWin | ku |
| SuperS | ca |
| SportGully | va |
| MrQ | ej |
| Xiaomi | yu |
| Siply | np |
| Meliuz | uy |
| Lamoda | sb |
| Zilch | zd |
| Biedronka | zn |
| Nanovest | je |
| CallApp | gw |
| Bit | qk |
| InFund | xi |
| Indomaret | ju |
| NoBroker | dv |
| LongHu | mk |
| FoodHub | iy |
| ZCity | ys |
| CrefisaMais | ax |
| Taikang | aw |
| Coindcx | ne |
| Dana | fr |
| Weidian | mf |
| Mewt | he |
| FWDMAX | od |
| Fora | gu |
| Tokopedia | xd |
| GoogleVoice | gf |
| Venmo | yy |
| Mercari | dg |
| DealShare | oc |
| YoWin | sm |
| OneAset | aj |
| Wink | ta |
| Dotz | cj |
| Hinge | vz |
| IPLwin | yv |
| Depop | xy |
| Alfagift | bn |
| GuruBets | ik |
| Fotka | rk |
| Stormgain | vj |
| Pivko24 | sz |
| TenChat | cr |
| Vlife | oq |
| Urent | of |
| AptekaRU | gk |
| LazyPay | bb |
| Любой другой | ot |