Dimar FZC LLC
Flamingo Villas A-32-01-05-03 25314 Združeni arabski emirati, Ajman
+971585072431, /assets/img/icons/logo/logo.svg, [email protected]

API protokol pre prácu so službou SMS-Activate

API je protokol medzi vaším softvérom a našim serverom

API je potrebné na automatizáciu procesu prijímania SMS, OTP a PVA na vašej strane

Naše API je plne kompatibilné s konkurenčnými stránkami

Všetky požiadavky musia smerovať na https://api.sms-activate.ai/stubs/handler_api.php

POST alebo GET požiadavka.

Všetky požiadavky musia obsahovať API kľúč vo forme GET parametra api_key

Stiahnuť implementáciu protokolu v PHP Stiahnuť hotovú implementáciu protokolu v Pythone

Aktivacijski API

Zahteva za razpoložljivo količino virtualnih številk
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country&operator=$operator

Parametri:

$api_key - API ključ

$country * - číslo krajiny pozri tabuľku

$operátor * čísla mobilných operátorov, môžete zadať niekoľko čísel oddelených čiarkami (dostupné len pre:

Rusko
megafon, mts, beeline, tele2, rostelecom, any
Ukrajina
kyivstar, life, utel, mts, vodafone
Kazachstan
tele2, beeline, activ, altel

** dostupné pre $country = 0, $country = 1, $country = 2

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{"vk_0":76,"ok_0":139,"wa_0":90,"vi_0":223,"tg_0":158,"wb_0":106,"go_0":182,"av_0":244,"av_1":211,"fb_0":107}
Kde za pomlčkou je názov služby, po označení, či je potrebné zahrnúť presmerovanie. 0 - nie. 1 - áno.

Popoln seznam storitev

Zahteva za najbolj priljubljene države po storitvi FreePrice
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getTopCountriesByService&service=$service&freePrice=$freePrice

Parametri:

$api_key - API ključ

$service * - Služba pozri tabuľku

* voliteľný parameter. Ak nie je zadaný, predvolene sa zobrazia top krajiny pre všetky služby.

$freePrice * - voliteľný parameter. Ak je uvedený true, množstvo a cena budú poskytnuté podľa Free Price

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{ 0: { "country: 0, "count": 43575, "price": 15.00, "retail_price": 30.00 }, ... }

$freePrice = true:

{ 0: { "country: 0, "count": 43575, "price": 15.00, "retail_price": 30.00, "freePriceMap": { "15.00": 43242, "18.00": 333 } }, ... }
Preverjanje stanja
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getBalance

Žiadosť o zostatok s účtom cashback:

https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getBalanceAndCashBack

* vráti zostatok so zohľadnením nazbieraného cashbacku, ak je v nastaveniach účtu cashback začiarknuté políčko 'Použiť cashback na aktiváciu'

Parametri:

$api_key - API ključ

ODGOVOR:

ACCESS_BALANCE: 'zostatok na účte'

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

ERROR_SQL - chyba sql-servera

Zahteva za razpoložljive operaterje
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getOperators&country=$country

* vráti všetkých operátorov dostupných pre zadanú krajinu; ak krajina nie je zadaná, vráti všetkých operátorov dostupných pre každú krajinu

Parametri:

$api_key - API ključ

$country - kód krajiny

ODGOVOR:

Odpoveď služby bude vo formáte JSON:

{"status":"success", "countryOperators": {
"Country1Code": ["operator1Name","operator2Name","operator3Name", ...],
"Country2Code": ["operator1Name","operator2Name","operator3Name", ...],
...
}}

Príklad:

{"status":"success", "countryOperators": {
"0": ["beeline","megafon","mts", ...],
"1": ["life","mts","kyivstar","utel" ...],
...
}}

* vnútri 'countryOperators' bude kľúčom kód krajiny

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

ERROR_SQL - chyba sql-servera

OPERATORS_NOT_FOUND - neboli nájdené žiadne záznamy (napr. bola zadaná neexistujúca krajina)

Zahteva za aktivne aktivacije
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getActiveActivations

Parametri:

$api_key - API ključ

ODGOVOR:

Odpoveď služby bude vo formáte JSON:

{"status":"success", "activeActivations": [
{
"activationId" : "635468021",
"serviceCode" : "vk",
"phoneNumber" : "79********1",
"activationCost" : "12.50",
"activationStatus" : "4",
"smsCode" : ["CODE"],
"smsText" : "[Your CODE registration code]",
"activationTime" : "2022-06-01 16:59:16",
"discount" : "0.00",
"repeated" : "0",
"countryCode" : "0",
"countryName" : "Russia",
"canGetAnotherSms" : "1",
}]

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

ERROR_SQL - chyba sql-servera

NO_ACTIVATIONS - záznamy neboli nájdené (žiadne aktívne aktivácie)

Zahteva za številko FreePrice
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&forward=$forward&operator=$operator&ref=$ref&country=$country&phoneException=$phoneException&maxPrice=maxPrice&useCashBack=$useCashBack&activationType=$activationType&language=$language&userId=$userId

Parametri:

$api_key - API ključ

$service - služba na objednanie pozri tabuľku

$forward * - či je potrebné vyžiadať číslo s presmerovaním

* voliteľný parameter, prijíma 0 (nevykonávať, predvolené), 1 (vykonať)

$maxPrice * - maximálna cena, za ktorú ste ochotní kúpiť číslo pri Free Price

* voliteľný parameter, ak nie je zadaný, nákup sa uskutoční za bežnú cenu

$phoneException * - vylúčenie prefixov pre ruské čísla. Zadávajte oddelené čiarkou. Formát zápisu: kód krajiny a 3 až 6 číslic masky (napr. 7918, 7900111). Predvolená hodnota je hodnota zadaná v účte.

$operator* je mobilni operater številke, lahko navedete več operaterjev, ločenih z vejico (na voljo samo za **)

$activationType - vrsta aktivacije: 0 - s SMS-om (privzeto), 1 - s številko, 2 - z glasovnim klicem

$language - jezik razčlenjevanja (obvezno za aktivacijo z glasovnim klicem) pozri tabuľku

$userId * - ID uporabnika za blokado zaradi slabih statistik aktivacij, vendar to ne vpliva na račun posrednika.

Rusko
megafon, mts, beeline, tele2, rostelecom, any
Ukrajina
kyivstar, life, utel, mts, vodafone
Kazachstan
tele2, beeline, activ, altel

* izbirno polje

** dostupné pre $country = 0, $country = 1, $country = 2

$ref - posredujte ID napotitve.

$country - číslo krajiny pozri tabuľku

$useCashBack* - sprejema logično vrednost; če je parameter 'true', bo nakup številke izveden s porabo povračila denarja. Ko zmanjka sredstev na stanju povračila, se vsi naslednji nakupi izvedejo z glavnim stanjem. POMEMBNO je vedeti, da bodo vsi naslednji nakupi najprej uporabili povračilo denarja in šele nato glavno stanje (tudi če kasneje posredujete parameter 'false').

* izbirni parameter, sprejema 'true'

Z pridobitvijo številke prek API-ja se strinjate s pogoji pravila projekta pravila projekta

MOŽNÉ CHYBY:

WRONG_MAX_PRICE:$min- navedena največja cena je nižja od dovoljene

$min - najnižja dovoljena cena

BAD_ACTION - nepravilno dejanje

BAD_SERVICE - nepravilno ime storitve

BAD_KEY - neplatný kľúč API

ERROR_SQL - chyba sql-servera

BANNED:'YYYY-m-d H-i-s' - čas, za katerega je račun blokiran

WRONG_EXCEPTION_PHONE - nepravilne izključene predpone

NO_BALANCE_FORWARD - nezadostna sredstva za nakup preusmeritve klicev

CHANNELS_LIMIT - račun blokiran

NO_NUMBERS - ni številk

Če poskusite pridobiti številko določenega operaterja, ki ne deluje v izbrani državi ali ki nima izbrane storitve, bo vrnjena številka prvega operaterja, ki ustreza parametrom zahteve

Zahteva za številko V2 FreePrice
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getNumberV2&service=$service&forward=$forward&operator=$operator&ref=$ref&country=$country&phoneException=$phoneException&maxPrice=maxPrice&activationType=$activationType&language=$language&userId=$userId

metoda deluje podobno kot metoda getNumber, sprejema iste parametre in dodatne, opisane spodaj, vendar vrača dodatne informacije o aktivaciji

Parametri:

$orderId- ID aktivacije iz sistema posrednika. Ob nakupu se ti podatki primerjajo z ID-jem aktivacije in posrednikom v našem sistemu. Tako želimo doseči idempotentnost (isti naročilo ne bo obdelano znova).

ODGOVOR:

Če je zahteva uspešna, bo odgovor v naslednji obliki:

{
"activationId": 635468024,
"phoneNumber": "79584******",
"activationCost": "12.50",
"countryCode": "0",
"canGetAnotherSms": "1",
"activationTime": "2022-06-01 17:30:57",
"activationOperator": "mtt"
}

Če poskusite pridobiti številko določenega operaterja, ki ne deluje v izbrani državi ali ki nima izbrane storitve, bo vrnjena številka prvega operaterja, ki ustreza parametrom zahteve

MOŽNÉ CHYBY:

ORDER_ALREADY_EXISTS- naročilo je že bilo ustvarjeno

Webhooki

Ko prejmete SMS na številko in imate v nastavitvah omogočeno funkcijo Webhooks, bomo podatke o SMS-u poslali na naslove, ki ste jih določili, z uporabo zahteve POST

ODGOVOR:

Oblika odgovora bo naslednja:

{
"activationId": 635468024,
"service": "go",
"text": "Your sms text",
"code": "Your sms code",
"country": 0,
"receivedAt": "2022-06-01 17:30:57",
}

Pri pošiljanju zahteve bomo počakali na odgovor vašega skripta s statusom HTTP 200. Če vaš skript ne odgovori, bomo zahtevo ponovno poslali v roku 2 ur, vendar največ 8-krat.

To funkcionalnost lahko omogočite v nastavitvah profila

Naročanje virtualne številke za več storitev
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getMultiServiceNumber&multiService=$service&multiForward=$forward&operator=$operator&ref=$ref&country=$country

Parametri:

$api_key - API ključ

$service - služba na objednanie pozri tabuľku

$forward * - či je potrebné vyžiadať číslo s presmerovaním

* izbirni parameter, znaki za posredovanje so ločeni z vejicami, število mest za posredovanje mora ustrezati številu storitev, prenesenih v parametru $service. Dovoljeno je posredovati samo 1 storitev s preusmeritvijo, na primer "0,1,0,0" - pravilno, "0,1,1,0" - nepravilno. Vrednosti: 0 (ne izvedi, privzeto), 1 (izvedi)

$operator * - mobilni operater številke, lahko navedete več številk, ločenih z vejicami (na voljo samo za **):

Rusko
megafon, mts, beeline, tele2, rostelecom, any
Ukrajina
kyivstar, life, utel, mts, vodafone
Kazachstan
tele2, beeline, activ, altel

$ref - posredujte ID napotitve.

$country - číslo krajiny pozri tabuľku

Z pridobitvijo številke prek API-ja se strinjate s pogoji pravila projekta pravila projekta

ODGOVOR:

NO_NUMBERS - ni številk

NO_BALANCE - stanje je porabljeno

{{'phone':phone,'activation':activation,'service':service},
{'phone':phone,'activation':activation,'service':service}}
, kjer (phone - ID operacije, activation - Telefonska številka, service - Storitev)

MOŽNÉ CHYBY:

BAD_ACTION - nepravilno dejanje

BAD_SERVICE - nepravilno ime storitve

BAD_KEY - neplatný kľúč API

ERROR_SQL - chyba sql-servera

BANNED:'YYYY-m-d H-i-s' - čas, za katerega je račun blokiran

Sprememba statusa aktivacije
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id&forward=$forward

Parametri:

$api_key - API ključ

$id - ID aktivacije

$forward * - telefonska številka, na katero želite posredovati

* zahtevano samo, če je bil parameter posredovan z getNumber forward=1.

$status - status aktivacije

1 - obvesti o razpoložljivosti številke (SMS poslan na številko)

3 - zahtevaj še eno kodo (brezplačno)

6 - končaj aktivacijo *

8 - sporoči, da je bila številka že uporabljena, in prekliči aktivacijo

* če je obstajal status 'koda prejeta' - označi kot uspešno in zaključi, če je bil status 'priprava' - izbriše in označi napako, če je bil status 'čakanje na ponovni poskus' - prenese aktivacijo v čakajoče SMS-e

** Ni mogoče spremeniti statusa aktivacije, za katero je bila izbrana metoda preverjanja s klicem, če je številka že prispela

Preprosta logika kronologije dela z API-jem:

Pridobitev številke z metodo getNumber, nato so na voljo naslednja dejanja:

8 - prekliči aktivacijo (če številka ni ustrezna)

1 - obvesti, da je bil SMS poslan (izbirno)

Za aktivacijo s statusom 1:

8 - prekliči aktivacijo

Takoj po prejemu kode:

3 - zahtevaj še en SMS

6 - potrdi SMS-kodo in končaj aktivacijo

Za aktivacijo s statusom 3:

6 - potrdi SMS-kodo in končaj aktivacijo

ODGOVOR:

ACCESS_READY - pripravljenost številk potrjena

ACCESS_RETRY_GET - čakanie na novú SMS

ACCESS_ACTIVATION - služba bola úspešne aktivovaná

ACCESS_CANCEL - aktivácia zrušená

MOŽNÉ CHYBY:

EARLY_CANCEL_DENIED - zrušenie čísla nie je povolené v prvých 2 minútach

ERROR_SQL - chyba sql-servera

NO_ACTIVATION - ID aktivácie neexistuje

BAD_SERVICE - nepravilno ime storitve

BAD_STATUS - nesprávny stav

BAD_KEY - neplatný kľúč API

BAD_ACTION - nepravilno dejanje

WRONG_ACTIVATION_ID - nesprávne ID alebo ID nie je číslo.

Pridobitev statusa aktivacije
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

Parametri:

$api_key - API ključ

$id - ID aktivacije

ODGOVOR:

STATUS_WAIT_CODE - čakanie na SMS

STATUS_WAIT_RETRY: 'minulosť, nezhodný kód' - čakanie na objasnenie kódu

STATUS_WAIT_RESEND - čakanie na opätovné odoslanie SMS *

* softvér musí stlačiť tlačidlo pre opätovné odoslanie SMS a zmeniť stav na 6

STATUS_CANCEL - aktivácia zrušená

STATUS_OK: 'aktivačný kód' - kód prijatý

MOŽNÉ CHYBY:

NO_ACTIVATION - ID aktivácie neexistuje

ERROR_SQL - chyba sql-servera

BAD_KEY - neplatný kľúč API

BAD_ACTION - nepravilno dejanje

Pridobitev statusa aktivacije – različica 2
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getStatusV2&id=$id

Parametri:

$api_key - API ključ

$id - ID aktivacije

ODGOVOR:

Oblika odgovora bo naslednja:

{
"verificationType": 2,
"sms": {
"dateTime": "0000-00-00 00:00:00",
"code": "code",
"text": "sms text",
},
"call": {
"from": "phone",
"text": "voice text",
"dateTime": "0000-00-00 00:00:00",
"url": "voice file url",
"parsingCount": 1,
}
}

STATUS_CANCEL - aktivácia zrušená

MOŽNÉ CHYBY:

NO_ACTIVATION - ID aktivácie neexistuje

ERROR_SQL - chyba sql-servera

BAD_KEY - neplatný kľúč API

BAD_ACTION - nepravilno dejanje

Pridobitev zgodovine aktivacij
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getHistory&start=$start&end=$end&offset=$offset&limit=$limit

Parametri:

$api_key - API ključ

$start - časová pečiatka vo formáte Unix Timestamp (voliteľné) - od ktorého dátumu sa majú považovať aktivácie

$end - časová pečiatka vo formáte Unix Timestamp (voliteľné) - do ktorého dátumu sa majú považovať aktivácie

$offset - posun prvého prvku vráteného v odpovedi. Predvolená hodnota je 0

$limit - maximálny počet vrátených záznamov. Maximum je 100. Predvolená hodnota je 50.

ODGOVOR:

Oblika odgovora bo naslednja:

[{
"id": 635468024,
"date": "2022-11-12 15:58:39",
"phone": "79918529716",
"sms": "sms":"["Your sms code"]",
"cost": 100 //Если активация не завершена, то cost = 0,
"status": "4",
}]

MOŽNÉ CHYBY:

ERROR_SQL - chyba sql-servera

BAD_KEY - neplatný kľúč API

BAD_ACTION - nepravilno dejanje

Pridobitev TOP 10 držav po storitvi
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getListOfTopCountriesByService&service=$service

Parametri:

$api_key - API ključ

$service - názov služby

ODGOVOR:

Oblika odgovora bo naslednja:

[{
"country": 0,
"share": 50 - // (Purchases of the chosen service by country as a percentage of the total quantity of purchases at our service),
"rate": 50 - // (% of successful activations among the total number of activations by the country)
}]

MOŽNÉ CHYBY:

ERROR_SQL - chyba sql-servera

BAD_KEY - neplatný kľúč API

WRONG_SERVICE - nesprávna služba

BAD_ACTION - nepravilno dejanje

Pridobitev statusa dohodnega klica
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getIncomingCallStatus&activationId=$id

Parametri:

$api_key - API ključ

$id - ID aktivacije

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{"status":"2","phone":false}

MOŽNÉ STAVY:

2 - nová aktivácia

3 - úspešne dokončené

4 - zrušené

5 - vrátené

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

NEPLATNÉ_ID_AKTIVÁCIE - Neplatné ID aktivácie

Pridobitev trenutnih cen po državah
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

Parametri:

$api_key - API ključ

$serviceKrátke meno služby (voliteľné, predvolene všetky služby) pozri tabuľku

$countryNázov kódu krajiny (voliteľné, predvolene všetky krajiny) pozri tabuľku

ODGOVOR:

JSON - objekt v formatu
{"Krajina":{"Služba":{"cena":Cena,"počet":Počet}}}

Pridobitev ažurnih cen za storitve preverjanja
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getPricesVerification&service=$service

Parametri:

$api_key - API ključ

$serviceKrátke meno služby (voliteľné, predvolene všetky služby) pozri tabuľku

ODGOVOR:

JSON - objekt v formatu
{"Služba":{"Krajina":{"počet":Množstvo,"cena":"Cena"}}}

Pridobitev seznama vseh držav
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getCountries

Parametri:

$api_key - API ključ

ODGOVOR:

JSON - objekt v formatu {{'Страна':{'id':0,'rus':"Россия","eng:"Russia","chn":"俄罗斯","visible":1,"retry":1,"rent":1,"multiService":1}},

kjer (

id : ID države;

rus : ime države v rusščini;

eng : ime države v angleščini;

chn : ime države v kitajščini;

visible : 0 - država ni prikazana na spletnem mestu, 1 - prikazana;

retry : 0 - ponovni SMS NI na voljo, 1 - na voljo;

rent : 0 - država ni oddana v najem, 1 - oddana;

multiService : 0 - država NI na voljo za več storitev, 1 - na voljo.)

Pridobitev seznama vseh storitev
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getServicesList

Parametri:

$api_key- API ključ

$country *- ID države. Če ste navedli državo, vam vrnemo storitve, ki imajo ceno za izbrano državo

$lang *- kateri jezik uporabiti za prikaz `name`. Možne vrednosti: 'ru', 'en', 'es', 'cn'. Privzeto je 'en'

* neobvezen parameter

ODGOVOR:

JSON - objekt v formatu { "status": "success", "services": [ { "code": "aoo", "name": "Pegasus Airlines" } ] }

Dodatna storitev za posredovane številke

Po prijatí prvej SMS pre presmerované čísla si môžete zakúpiť ďalšie súvisiace služby, ako sú Yula, Yandex, Avito a iné.

Cena dodatočnej služby je len 5p

https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getAdditionalService&service=$service&id=$id

Parametri:

$api_key - API ključ

$service - pre krátke meno služby pozrite tabuľku pozri tabuľku

$id - ID nadradenej aktivácie

ODGOVOR:

DODATOČNÉ:$id:$telefón - nová aktivácia bola úspešne vytvorená. Kde ID je ID dodatočnej aktivácie, telefón je telefónne číslo

MOŽNÉ CHYBY:

NESPRÁVNA_DODATOČNÁ_SLUŽBA - Neplatná dodatočná služba (povolené sú len služby na presmerovanie)

WRONG_ACTIVATION_ID - Nesprávne ID nadradenej aktivácie

NESPRÁVNE_ZABEZPEČENIE - došlo k chybe pri pokuse o odoslanie ID aktivácie bez presmerovania alebo dokončenej/neaktívnej aktivácie

OPAKOVANIE_DODATOČNEJ_SLUŽBY - chyba nastane pri pokuse o opätovné objednanie už zakúpenej služby NEDOSTATOČNÝ_ZOSTATOK - Nedostatok finančných prostriedkov

ERROR_SQL- chyba databázy, kontaktujte zákaznícku podporu

Opätovná aktivácia virtuálneho čísla

Ak ste na čísle vykonali úspešnú aktiváciu, môžete ju zopakovať.

Cena dodatočnej aktivácie sa určuje v závislosti od krajiny a služby. Konkrétnu cenu získate z .

https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getExtraActivation&activationId=$activationId

Parametri:

$api_key - API ključ

$activationId - ID nadradenej aktivácie

ODGOVOR:

PRÍSTUP_K_ČÍSLU:$id:$telefón - nová aktivácia bola úspešne vytvorená. Kde $id je ID dodatočnej aktivácie, $phone je telefónne číslo

MOŽNÉ CHYBY:

OBNOVENIE_AKTIVÁCIE_NIE_JE_MOŽNÉ- číslo nie je dostupné pre dodatočnú aktiváciu

WRONG_ACTIVATION_ID - Nesprávne ID nadradenej aktivácie

ERROR_SQL- chyba databázy, kontaktujte zákaznícku podporu

NOVÁ_AKTIVÁCIA_NIE_JE_MOŽNÁ- nie je možné vykonať dodatočnú aktiváciu

NO_BALANCE - žiadne peniaze na účte

Získajte cenu za dodatočnú aktiváciu čísla

Môžete zistiť dostupnosť čísla pre dodatočnú aktiváciu a získať jeho cenu

https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=checkExtraActivation&activationId=$activationId

Parametri:

$api_key - API ključ

$activationId - ID nadradenej aktivácie

ODGOVOR:

JSON - objekt v formatu {'status': 'success', 'cost':200,"service":"tw","phone":777777777,"country":14},

MOŽNÉ CHYBY:

OBNOVENIE_AKTIVÁCIE_NIE_JE_MOŽNÉ- číslo nie je dostupné pre dodatočnú aktiváciu

WRONG_ACTIVATION_ID - Nesprávne ID nadradenej aktivácie

SIM_OFFLINE - SIM karta je offline

Ponovna glasovna obdelava
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=parseCall&id=$id&newLang=$newLang

Parametri:

$api_keyapi kľúč

$id - ID aktivacije

$newLang - nový jazyk parsovania pozri tabuľku

ODGOVOR:

Oblika odgovora bo naslednja:

{
"result": "OK"
}

STATUS_CANCEL - aktivácia zrušená

ŽIADNY_HOVOR- klic ni bil prejet

PARSE_COUNT_EXCEED- omejitev števila poskusov razčlenjevanja (največ 4)

MOŽNÉ CHYBY:

WRONG_ACTIVATION_ID - neveljaven ID, aktivacija ne obstaja

ERROR_SQL - chyba sql-servera

BAD_KEY - neplatný kľúč API

BAD_ACTION - nepravilno dejanje

Najem API-ja

Zahteva za razpoložljive države in storitve
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getRentServicesAndCountries&rent_time=$time&operator=$operator&country=$country&incomingCall=$incomingCall

Parametri:

$api_key - API ključ

$time* - čas najema (privzeto: 4 ure)

$operator* - mobilni operater številke, lahko navedete več operaterjev, ločenih z vejicami (privzeto: katerikoli)

$country* - država (privzeto: Rusija)

$incomingCall * - če je posredovano "true"pridobite številko s podporo za funkcijo prejemanja klicev

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{ "countries": { "0": 0 }, "operators": { "0": "aiva", "1": "any", "2": "beeline", ... "16": "yota" }, "services": { "full": { "cost": 42.93, "quant": 20 }, "vk": { "cost": 21.95, "quant": 20 }, "ok": { "cost": 7.68, "quant": 55 }, "ot": { "cost": 5.2, "quant": 42 } } }

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

OUT_OF_STOCK - številke za to državo niso na voljo

Naročilo najema virtualne številke
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getRentNumber&service=$service&rent_time=$time&operator=$operator&country=$country&url=$url&incomingCall=$incomingCall

Parametri:

$api_key - API ključ

$service - storitev, za katero potrebujete številko

$time* - čas najema v urah (privzeto: 4 ure). Naslednji razpoložljivi časovni intervali so 12 ur, nato 24 ur. Pri zahtevi za najem za en dan ali več morate navesti: 24, 48, 72 itd.

$operator* - mobilni operater številke, lahko navedete več operaterjev, ločenih z vejicami (privzeto: katerikoli)

$country* - država (privzeto: Rusija)

$url * - povezava za webhook (privzeto se ne upošteva)

$incomingCall * - če je posredovano "true"pridobite številko s podporo za funkcijo prejemanja klicev

Kaj je webHook?

* izbirni parameter. Če ni določen, se uporabi privzeti parameter.

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{ "status": "success", "phone": { "id": 1049, "endDate": "2020-01-31T12:01:52", "number": "79959707564" } }

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

Odgovor v formatu JSON:

{ "status": "error", "message": "*možen_odgovor*" }


Možni odgovori v polju "message":

BAD_SERVICE - storitev ni določena ali je ime napačno

NO_BALANCE - žiadne peniaze na účte

NO_NUMBERS - ni številk

ACCOUNT_INACTIVE - ni številk

SERVER_ERROR - napaka strežnika

CHANNELS_LIMIT - račun blokiran

Pridobitev statusa za najem
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getRentStatus&id=$id&page=$page&size=$size

Parametri:

$api_key - API ključ

$id - ID najema, prejet v odgovoru ob naročilu številke

$page* - številka strani, od katere se začne izbor (številčenje strani se začne z 0, od novejših proti starejšim; privzeto je 0)

$size* - velikost strani (privzeto 10)

* izbirni parameter. Če ni določen, se uporabi privzeti parameter.

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{ "status": "success", "quantity": "2", "values": { "0": { "phoneFrom": "79180230628", "text": "5", "service": "ot", "date": "2020-01-30 14:31:58" }, "1": { "phoneFrom": "79180230628", "text": "4", "service": "ot", "date": "2020-01-30 14:04:16" } } }

* uspešno le, ko obstaja SMS (polje 'quantity' > 0).

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

Odgovor v formatu JSON:

{ "status": "error", "message": "*možen_odgovor*" }

Možni odgovori v polju "message":

NO_ID_RENT - ID najema ni določen

INVALID_PHONE - številka ni najeta s strani vas (neveljaven ID najema)

STATUS_FINISH - najem plačan in zaključen

STATUS_CANCEL - najem preklican z vračilom sredstev

STATUS_WAIT_CODE - čakanje na prvi SMS

STATUS_REVOKE - številka je blokirana, vaša sredstva so bila vrnjena

Sprememba statusa najema
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=setRentStatus&id=$id&status=$status

Parametri:

$api_key - API ključ

$id - ID najema, prejet v odgovoru ob naročilu številke

$status - koda za spremembo statusa (številke)

Status je lahko:

1
Zaključi
2
Zrušiť

ODGOVOR:

Odpoveď služby bude vo formáte JSON:

{ "status": "success" }

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

Odgovor v formatu JSON:

{ "status": "error", "message": "*možen_odgovor*" }

Možni odgovori v polju "message":

NO_ID_RENT - ID najema ni določen

INCORECT_STATUS - manjkajoč ali nepravilno naveden status

CANT_CANCEL - najema ni mogoče preklicati (več kot 20 min.)

INVALID_PHONE - številka ni najeta s strani vas (neveljaven ID najema)

ALREADY_FINISH - najem je že bil zaključen

ALREADY_CANCEL - najem je že bil preklican

SERVER_ERROR - napaka strežnika

Seznam trenutnih aktivacij
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getRentList

👉Pozor! Ta metoda prikazuje le zadnjih 10 številk. Če potrebujete več številk, uporabite getRentStatus metodo za preverjanje statusov.

Parametri:

$api_key - API ključ

ODGOVOR:

Odpoveď služby bude vo formáte JSON:

{ "status": "success", "values": { "0": { "id": "12345", "phone": "79181234567" }, "1": { "id": "12345", "phone": "79181234568" } } }

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

BAD_ACTION - nepravilno dejanje


Odgovor v formatu JSON:

{ "status": "error", "message": "*možen_odgovor*" }


Možni odgovori v polju "message":

NO_NUMBERS - ni najetih številk

SERVER_ERROR - napaka strežnika

Podaljšanje najema
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=continueRentNumber&id=$id&rent_time=$time

Parametri:

$api_key - API ključ

$id - id najema

$rent_time- čas najema (privzeto: 4 ure)

ODGOVOR:

Odpoveď služby bude vo formáte JSON:

{ "status": "success", "phone": { "id": 1049, "endDate": "2020-01-31T12:01:52", "number": "79959707564"} }

Ko se zaključen najem podaljša, bo ponovno naročen in zagotovljen nov ID

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

BAD_ACTION - nepravilno dejanje

SERVER_ERROR - napaka strežnika


Odgovor v formatu JSON:

{ "status": "error", "message": "*possible_answer*", "info": "*details*" }


Možni odgovori v polju "message":

NO_ID_RENT - ni ID-ja najema

INVALID_TIME - napačen čas. Na voljo je od 4 do 1344 ur

MAX_HOURS_EXCEED - presežen je bil največji razpoložljivi čas

info:

max - največji razpoložljivi čas

INVALID_PHONE - neveljaven ID najema

RENT_DIE - najem ni mogoče podaljšati, ker je številka potekla

NO_BALANCE - nezadostna sredstva

CHANNELS_LIMIT - račun blokiran

Pridobitev stroška podaljšanja najema
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getContinueRentPriceNumber&id=$id&rent_time=$time

* ta metoda je na voljo samo za najem pri operaterju MTT.

Parametri:

$api_key - API ključ

$id - id najema

$rent_time - čas najema

ODGOVOR:

Odpoveď služby bude vo formáte JSON:

{ "status": "success", "price": 6.33 }

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

BAD_ACTION - nepravilno dejanje

SERVER_ERROR - napaka strežnika


Odgovor v formatu JSON:

{ "status": "error", "message": "*možen_odgovor*" }


Možni odgovori v polju "message":

NO_ID_RENT - ni ID-ja najema

INVALID_PHONE - neveljaven ID najema

INVALID_TIME - nepravilna nastavitev časa

RENT_DIE - najem ni mogoče podaljšati, ker je številka potekla

MAX_HOURS_EXCEED - presežen je bil največji razpoložljivi čas

info:

max - največji razpoložljivi čas

CHANNELS_LIMIT - račun blokiran

API JAVA

Začetek dela

Vključite knjižnico v Maven

<odvisnost><groupId>ru.sms-activate</groupId>
<artifactId>SMSActivateApi</artifactId>
<version>1.0</version>
</dependecy>

Primer registracije si lahko ogledate na povezavi do MavenRepository

Uvozite glavni razred za interakcijo z API-jem SMS-Activate.

import ru.sms_activate.SMSActivateApi

Za uporabo knjižnice potrebujete ključ API, ki ga lahko pridobite na tej strani in prek spodnje povezave.

SMS-Activate API-Key
Primer dela s stanjem

Za pridobitev trenutnega stanja na vašem računu uporabite metodo getBalance... Če vas poleg stanja zanima tudi povračilo denarja (cashback), pokličite metodo getBalanceAndCashBack.

Metoda getBalanceAndCashBack vrne objekt razredaSMSActivateGetBalanceAndCashBack.

getBalance: Pridobi trenutno stanje na računu

Parametri:

NONE

VRNITVENI TIP:

BigDecimal

getBalanceAndCashBack: Pridobi stanje in znesek povračila denarja kot skupno stanje

Parametri:

NONE

getNumber: Pridobi aktivacijo

Parametri:

countryId(Integer) - identifikator države.

service(String) - kratko ime storitve.

forward*(boolean) - ali zahtevati številko s posredovanjem klicev.

operatorSet*(Množina) - množina operátorov.

phoneException*(Množina) - okrem predčísel iba pre Rusko, množina čísel od 3 do 6 (7918,7900111).

* voliteľné pole. Ak nie je nič špecifikované, predvolené množstvo bude určené podľa nastavenia v profile.

VRNITVENI TIP:

SMSActivateActivation

getNumberStatus: Získanie informácií o dostupných službách

Parametri:

countryId(Integer) - identifikator države.

operatorSet*(Množina) - množina operátorov, ktorí sú dostupní pre službu

getAdditionalService: Vráti dodatočnú službu pre číslo s presmerovaním hovorov.

Parametri:

id(Celé číslo) - identifikátor aktivácie

service(String) - kratko ime storitve.

Namiesto identifikátora aktivácie môžete po použití metódy poslať prijatý objekt triedy SMSActivateActivation po použití metódy getNumber alebo jednu z aktivácií po použití getMultiServiceNumber.

getMultiServiceNumber: Získanie aktivácie pre viacero služieb

Parametri:

countryId(Integer) - identifikator države.

serviceMap(Množina) - množina služieb, pre ktoré je zakúpená aktivácia

multiForwardList(Zoznam) - zoznam služieb s dostupným presmerovaním hovorov

operatorSet(Množina) - množina operátorov.

getAllPrices: Získanie kompletného zoznamu cien aktivácií

Parametri:

NONE

VRNITVENI TIP:

SMSActivateGetPriceInfo

getPricesByCountryIdAndServiceShortName: Získanie zoznamu cien aktivácií podľa krajiny a služby

Parametri:

countryId(Integer) - identifikator države.

service(String) - kratko ime storitve.

VRNITVENI TIP:

SMSActivateGetPriceInfo

getPricesAllServicesByCountryId: Získanie zoznamu cien aktivácií podľa krajiny

Parametri:

countryId(Integer) - identifikator države.

VRNITVENI TIP:

SMSActivateGetPriceInfo

getStatus: Získanie stavu aktivácie

Parametri:

activationId(Celé číslo) - identifikátor aktivácie

Namiesto identifikátora aktivácie môžete po použití metódy poslať prijatý objekt triedy SMSActivateActivation po použití metódy getNumber alebo jednu z aktivácií po použití getMultiServiceNumber.

setStatus: Nastavenie stavu aktivácie

Parametri:

id(Celé číslo) - identifikátor aktivácie

status(SMSActivateClientStatus) - stav, ktorý má byť nastavený pre aktiváciu

Namiesto identifikátora aktivácie môžete po použití metódy poslať prijatý objekt triedy SMSActivateActivation po použití metódy getNumber alebo jednu z aktivácií po použití getMultiServiceNumber.

getCountries: Získanie informácií o krajinách

Parametri:

NONE

getFullSms: Získanie úplného textu SMS z čísla

Parametri:

activationId(Celé číslo) - identifikátor aktivácie

Namiesto identifikátora aktivácie môžete po použití metódy poslať prijatý objekt triedy SMSActivateActivation po použití metódy getNumber alebo jednu z aktivácií po použití getMultiServiceNumber.

Algoritmus na získanie úplného textu SMS pri aktivácii

Pridobitev številke z metodo getNumber, nato so na voljo naslednja dejanja:

CANCEL - 8 - Zrušiť aktiváciu (ak vám číslo nevyhovuje)

MESSAGE_WAS_SENT - Obvesti, da je bil SMS poslan (obvezno za prejemanje celotnega besedila SMS-a)

Po obvezni nastavitvi statusa MESSAGE_WAS_SENT nastavite spremenljivko za prejemanje SMS-ov z uporabo metode waitSMS s parametri aktivacije in časom čakanja na SMS.

Po prejemu SMS-a ga lahko pridobite z metodo getFullSMS in nato prikažete celotno besedilo z metodo getText().

Nato lahko aktivacije nastavite na naslednje statusе:

Za aktivacijo s statusom MESSAGE_WAS_SENT:

CANCEL - Prekliči aktivacijo

Takoj po prejemu kode:

REQUEST_ONE_MORE_CODE - Zahtevaj še en SMS

FINISH - Potrdi kodo SMS in dokončaj aktivacijo

Za aktivacijo s statusom REQUEST_ONE_MORE_CODE:

FINISH - Potrdi kodo SMS in dokončaj aktivacijo

getRentNumber: Pridobi številko z možnostjo najema

Parametri:

countryId(Integer) - identifikator države.

service(String) - kratko ime storitve.

hours(Integer)* - čas najema

operator(String)* - ime mobilnega operaterja

urlWebhook(String)* - povezava za webhook (privzeto ni upoštevano)

Kaj je webHook?

* izbirni parameter. Če ni določen, bo privzeti

VRNITVENI TIP:

SMSActivateRentActivation

GetRentServicesAndCountriesRun: Pridobi storitve in države za najem

Parametri:

countryId(Integer) - identifikator države.

operatorSet(Množina) - niz mobilnih operaterjev

hours(Integer)* - čas najema

* izbirni parameter. Če ni določen, bo privzeti

GetRentStatusJava: Pridobi status za najem

Parametri:

rentId(Integer) - identifikator najete številke

Namesto rentId lahko posredujete rezultirajoči objektni razred SMSActivateRentActivation po použití metódy getRentNumber

VRNITVENI TIP:

SMSActivateRentStatus

E-poštni API

Opis API statusov

3 - Čakanje

4 - Preklicano

5 - Uspešno

Poštni API – različica 2

OPIS:

Strožje upoštevanje načel REST API-ja in povečano število gmail.com poštnih predalov za registracijo Telegram računov.

Pridobitev seznama ponudb
https://api.sms-activate.ai/stubs/handler_api.php?action=getDomains&api_key=$api_key&site=$site

Parametri:

$api_key - API ključ

$site- Spletna stran, za katero potrebujete e-pošto

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{
                        "status":"OK",
                        "response":{
                            "zones":[
                                {
                                "name":"info",
                                "cost":2.5
                                },
                                ...
                            ],
                            "popular":[
                                {
                                "name":"mail.ru",
                                "cost":6,
                                "count":159008
                                },
                                ...
                            ]
                        }
                        }

MOŽNÉ CHYBY:

BAD_SITE- Spletna stran ni določena

BAD_KEY - neplatný kľúč API

BAD_ACTION - nepravilno dejanje

Nakup preverjanja po e-pošti
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=buyMailActivation&site=$site&mail_type=$mail_type&mail_domain=$mail_domain

Parametri:

$api_key - API ključ

$site - spletna stran, za katero potrebujete e-pošto

$mail_type - vrsta pošte: priljubljene domene ali cone (1 - cone, 2 - priljubljene)

$mail_domain - izbrana cona ali domena

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{
                        "status":"OK",
                        "response":{"email":"[email protected]","id":241}
                        }

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

BAD_ACTION - nepravilno dejanje

MAIL_TYPE_ERROR - za navedeno spletno mesto takšna domena ne obstaja

CHANNELS_LIMIT - račun blokiran

Ponovna aktivacija e-pošte
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=reorderMailActivation&id=$id

Parametri:

$api_key - API ključ

$id- ID e-poštnega naslova, za katerega je potrebna ponovna aktivacija

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{
                            "status": "OK",
                        "response": {
                            "email": "[email protected]",
                            "id": 360
                            }
                        }

MOŽNÉ CHYBY:

BAD_KEY - neplatný kľúč API

BAD_ACTION - nepravilno dejanje

BLOCKED_SITE - blokirano spletno mesto

BAD_BALANCE - nezadostna sredstva

ACTIVATION_NOT_FOUND - aktivacija ni bila najdena

CHANNELS_LIMIT - račun blokiran

Pridobitev seznama aktivnih nakupov
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getMailHistory&page=$page&per_page=$per_page&search=$search&sort=$sort

Parametri:

$api_key - API ključ

$page- številka strani

$per_page- število nakupov na vsaki strani

$search- iskalno polje

$sort- smer razvrščanja (desc, asc)

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{
                        "status":"OK",
                        "response":{
                            "list":[
                                {
                                "id":"241",
                                "site":"apple.com",
                                "email":"[email protected]",
                                "status":"3",
                                "value":null,
                                "cost":"6.00",
                                "date":"2023-10-06 14:24:13",
                                "full_message":""
                                }
                            ],
                            "pages":1,
                            "count":1
                        }
                        }
Preklic nakupa e-pošte
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=cancelMailActivation&id=$id

Parametri:

$api_key - API ključ

$id- ID nakupa

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{
                        "status":"OK",
                        "response":true
                        }

MOŽNÉ CHYBY:

EARLY_CANCEL_DENIED - E-pošte ne morete preklicati v prvih 2 minutah.

Preverite, ali ste prejeli e-pošto
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=checkMailActivation&id=$id

Parametri:

$api_key - API ključ

$id- ID kupljenega e-poštnega naslova; vrne se po nakupu e-pošte

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{
                        "status":"OK",
                        "response":{
                            "value":"Содержания письма"
                        }
                        }

Programska oprema za API partnerje

Kupite programsko opremo za partnerje
https://api.sms-activate.ai/stubs/handler_api.php?action=buyPartnerProduct&productId=$id&api_key=$api_key

Parametri:

$api_key - API ključ

$id- ID programske opreme, ki jo morate kupiti

ODGOVOR:

Odpoveď služby bude vo formáte JSON, príklad:

{                            
                            "status": "success",
                            "key": "F5qrzFoY6afj3zrEq7SeMplbx",
                            "manual": "Software download link:"                            
                        }

MOŽNÉ CHYBY:

BAD_DATA - Nepravilen ID ali ID ni številka

BAD_ACTION - neveljavno dejanje ali preprodajalec ni preverjen.

                        <?php
                            include_once ("smsactivateApi.php");//Inclusion of a class in a project
                            $sms = new SMSActivate($API_KEY);//Create class instance SMSActivate

$freeSlots = $sms->getNumbersStatus(0, 'tele2');//Get the number of available numbers for the country of Russia and the tele2 operator echo "Номеров Вконтакте: " . $freeSlots['vk']."\n";//Show for Vk
echo "Номеров Whatsapp: " . $freeSlots['wa']."\n";//Show for whatsapp
var_dump($freeSlots); //Show all services with quantity
$array=$activate->getTopCountriesByService(); //Get an array whose elements contain information for each country $balance = $sms->getBalance();//Get balance echo "On the account " . $balance." rub.\n";//Show balance
$balance = $sms->getBalanceAndCashBack();//Request a balance with cashback account echo "On the account " . $balance." rub.\n";//Request a balance with cashback account
$operators = $sms->getOperators(); //Get operators for all countries if (in_array('mts', $operators['countryOperators'][0])) { //check if 'mts' is available for Russia //perform an action } if (in_array('chinamobile', $operators['countryOperators'][3])) { //check if 'chinamobile' is available for China //perform an action } $activations = $sms->getActiveActivations(); $number = $sms->getNumber('ok',0, 0, 'tele2');//Get Odnoklassniki number without forwarding echo "Activation № " . $number['id']. "Phone ". $number['number'] \n";//Show id and activation number
$result = $sms->getNumber('vk', 0 , 1); if (!is_array($result)) { echo 'Ошибка: ' . $result . '\n';//If an error occurs, a string will be returned, if successful, an array will be returned. } else { echo 'Id: ' . $result['id'] ."\n"; echo 'Номер: ' . $result['number'] ."\n"; }
$result = $sms->getNumberV2('vk', 0 , 1); $number = $sms->getMultiServiceNumber('ok,vk,vi,av','0,0,0,1', 0, 'tele2');//Get a number for services Odnoklassniki, Vkontakte, Viber without call forwarding and Avito with call forwarding foreach ($number as $value) { echo "Activation № " . $value['activation']. " for service ". $value['service'] ."\n"; }
echo "Number " . $value['phone'] ."\n";//Show activation id and number
$status = $sms->setStatus($number['id'], 3);//Change activation status by id (get 1 more code) $status = $sms->getStatus($number['id']);//Get activation status by id if (is_array($status) { echo "статус : " . $status['status'];//Can be STATUS_OK or STATUS_WAIT_RETRY, otherwise a line with error text will be returned echo "код: " . $status['code']; } else { echo $status ."\n"; } $incomingCall = $sms->getIncomingCallStatus($id);//Get activation data by call echo $incomingCall['phone'] //Show incoming number $prices = $sms->getPrices(1, 'vk');//Get the current price for the service echo "Price for VK (Ukraine) : " .$prices[1]['vk']['cost']." rub. quantity: ". $prices[1]['vk']['count'];//Show the result $countries = $sms->getCountries();//Get a list of all countries $additional = $sms->getAdditionalService('fx', $id);//Get additional activation for PGbonus service based on id activation echo "Activation no.: " . $additional[id] . " Telephone: " . $additional[number];//Show the result $getAvailableRentNumbers = $sms->getRentServicesAndCountries('2');//Request available countries for rent and services (for 2 hours for all operators) echo "Full rental - Cost:" . $getAvailableRentNumbers['services']['full']['cost'] . " Quant :" .$getAvailableRentNumbers['services']['full']['quant'] ." \n"; //Display full price information
foreach( $getAvailableRentNumbers['operators'] as $value) { echo " Operator " . $value ."\n"; }//List operators
$getRentNumber = $sms->getRentNumber('vk','10','0','yota');//Get a number for rent for Vkontakte for 10 hours, operator 'Yota', country - Russia if ($getRentNumber['status'] === 'success'){ echo "The rental was successful! Your phone number is: " . $getRentNumber['phone']['number']." \nRent expiration : ". $getRentNumber['phone']['endDate']." \nId numbers :" .$getRentNumber['phone']['id'] ; }//Display rental information
else echo "Error code : " . $getRentNumber['message'];
$getRentStatus = $sms->getRentStatus($getRentNumber['phone']['id']);//Get the rent status with id from the received number if ($getRentStatus['status'] == 'success'){ foreach( $getRentStatus['values']as $index => $value) { echo " Message " . $index .": from the number - " . $value['phoneFrom'] . " Service - " . $value ['service'] . "message text - " . $value['text'] . "Date - " . $value['date']; } }//display a list of messages received while renting a phone else echo "Error code : " . $getRentStatus['message']; $setRentStatus = $sms->setRentStatus($getRentNumber['phone']['id'],1);//Set rental status 'finish' with id from received number if ($setRentStatus['status'] == 'success') echo " Status change was successful! "; else echo "Error code : " . $setRentStatus['message']; $getRentList = $sms->getRentList();//Get a list of currently rented numbers if (getRentList['status'] == 'success') foreach( $getRentList['values'] as $value) { echo " ID " . $value["id"] . " Number " . $value["phone"] ."\n"; }//List numbers else echo "Error code : " . $getRentList['message']; $result = $sms->continueRentNumber($id);//Extend the lease of activation id for 4 hours (by default) if ($result['status'] == 'success') { echo "Number: " . $result['phone']['number']"//Display number echo "id: " . $result['phone']['id']"//Display activation id echo "The lease is valid until: " . $result['phone']['endDate']"//Display the date and time of the end of the lease } else { echo "Error code : " . $result['msg']; } $result = $sms->getContinueRentPriceNumber($id, 12);//Get the cost of renewing the lease to activate the id for 12 hours if ($result['status'] == 'success') { echo " Renewal cost " . $result['price'];//Withdraw the cost } else { echo "Error code: " . $result['message']; //Display error code }
                    
                        from smsactivate.wiki import SMSActivateAPI
                         # SMSActivateAPI Contains all basic tools for working with the SMSActivate API
                        sa = SMSActivateAPI(API_KEY)
sa.debug_mode = True # Used for debugging. When debug_mode is active, all responses from the server and class will be output to the console print(sa.version()) # Returns the current version of the library status = sa.getNumbersStatus(country=0, operator='tele2') try: print(status['vk_0']) # 274789 except: print(status['message']) # Error text
result = sa.getTopCountriesByService('vk') try: print(result[0]['count']) # 2350 except: print(result['message']) # Error text balance = sa.getBalance() # {'balance': '100.00'} try: print(balance['balance']) # 100.00 except: print(balance['message']) # Error text
balance = sa.getBalanceAndCashBack() # {'balance': '100.00'} try: print(balance['balance']) # 100.00 except: print(balance['message']) # Error text
operators = sa.getOperators(country=0) try: print(operators['countryOperators']['0']) except: print(operators['error']) # Error status activations = sa.getActiveActivations() try: print(activations['activeActivations']) except: print(activations['error']) # Error status number = sa.getNumber(service='vk', operator='tele2', country=0, verification="true") # {'activation_id': 000000000, 'phone': 79999999999} try: print(number['phone']) # 79999999999 except: print(number['message']) # Error text number = sa.getNumberV2(service='vk', country=0) try: print(number['phoneNumber']) # 79999999999 except: print(number['message']) # Error text multinumber = sa.getMultiServiceNumber(service='fb,ig', operator='tele2', country=0) # [{'phone': '79999999999', 'activation': 000000000, 'service': 'fb'}, {'phone': '79999999999', 'activation': 000000001, 'service': 'ig'}] try: print(multinumber[0]['phone']) # 79999999999 except: print(multinumber['message']) # Error text status = sa.setStatus(id=000000000, status=1) # ACCESS_READY try: print(status) # ACCESS_READY except: print(status['message']) # Error text status = sa.getStatus(id=000000000) # STATUS_WAIT_CODE try: print(sa.activationStatus(status)) # {'status': 'STATUS_WAIT_CODE', 'message': 'Ожидание смс'} except: print(status['message']) # Error text status = sa.getIncomingCallStatus(id=000000000) try: print(status['status']) # 2 except: print(status['message']) # Error text prices = sa.getPrices(service='fb', country=0) try: print(prices['0']) # {'fb': {'cost': 9, 'count': 27934}} except: print(prices['message']) # Error text countries = sa.getCountries() try: print(countries['0']['eng']) # Russia except: print(countries['message']) # Error text service = sa.getAdditionalService(id=000000000, service='ig') try: print(service['phone']) # 79999999999 except: print(service['message']) # Error text service = sa.getRentServicesAndCountries(time=4, operator='tele2', country=0) try: print(service['services']['full']['cost']) # 100.00 except: print(service['message']) # Error text rent = sa.getRentNumber(service='ig', time=4, operator='tele2', country=0) try: print(rent['phone']['number']) # 79999999999 except: print(rent['message']) # Error text status = sa.getRentStatus(000000000) try: print(status['values']['0']['text']) # SMS except: print(status['message']) # Error text status = sa.setRentStatus(id=000000000, status=1) try: print(status['status']) # success except: print(status['message']) # Error text rent = sa.getRentList() try: print(rent['values']['0']['phone']) # 79999999999 except: print(rent['message']) # Error text rent = sa.continueRentNumber(id=000000000, time=4) try: print(rent['phone']['number']) # 79999999999 except: print(rent['message']) # Error text rent = sa.getContinueRentPriceNumber(000000000) try: print(status['price']) # 4.00 except: print(status['message']) # Error text
                    
                        
                            import ru.sms_activate.SMSActivateApi;//Inclusion of a class in a project
SMSActivateApi smsActivateApi = new SMSActivate("API_KEY");//Create an instance of the SMSActivate class
BigDecimal balance = smsActivateApi.getBalance();//Get the current account balance System.out.println("Balance: "+ balance)//Withdraw the received balance SMSActivateGetBalanceAndCashbackResponse smsActivateGetBalanceAndCashbackResponse = smsActivateApi.getBalanceAndCashback();//Get current balance and cashback System.out.println("Cashback + balance: "+ smsActivateGetBalanceAndCashbackResponse.getBalanceAndCashback());//Withdraw the amount of balance and cashback SMSActivateActivation activation=smsActivateApi.getNumber(0,"vk")//Get activation for the Vkontakte service in Russia System.out.println(activation);//Withdraw the received activation SMSActivateGetNumbersStatusResponse smsActivateGetNumbersStatusResponse= smsActivateApi.getNumberStatus(0,null);//Get information about available services for Russia
SMSActivateServiceInfo go = smsActivateGetNumbersStatusResponse.getSMSActivateServiceInfoByShortName("go");//Getting information about numbers for the Google service
System.out.println("Short name service: " + go.getShortName();//Get the short name of the service System.out.println("count phone numbers: "+ go.getCountPhoneNumber();//Get the number of numbers for the service System.out.println(""Forwarding is available: "+ go.isForward() ? "yes" : "no"//Find out if the service has a redirect
SMSActivateActivation activation=smsActivateApi.getNumbersStatus(0,"ot",true);//Activations
smsActivateApi.setStatus(activation, SMSActivateClientStatus.MESSAGE_WAS_SENT);//Setting the MESSAGE_WAS_SENT status after sending SMS for the number
SMSActivateActivation childActivation =smsActivateApi.getAdditionalService(activation,"av");//Requesting a new activation for an additional service
System.out.println(childActivation);//Displaying information about additional activation
Set<String>operatorSet= new HashSet<>(); operatorSet.add("mts");//Adding an MTS operator to the set of operators Map<String,Boolean>serviceMap= new HashMap<>(); serviceMap.put("av",false);//Adding the Avito service to the list of services (specify true if you need a service with redirection)
SMSActivateGetMultiServiceNumberResponse multiServiceNumberResponse=smsActivateApi.getMultiServiceNumber(0, serviceMap, operatorSet);//Getting activation for multiple services
multiServiceNumberResponse.getSMSActivateActivationList().forEach(activation->{ System.out.println("Id: " + activation.getId()); System.out.println("Number: " + activation.getNumber()); System.out.println("Service name: " + activation.getShortName()); } //Displaying information about received activations
SMSActivateGetPricesResponse smsActivateGetPricesResponse=smsActivateApi.getPricesByCountryIdAndServiceShortName(0, "vk");//Obtaining a list of prices for Russia on the Vkontakte service. For a complete list of prices, use the getAllPrices () method;
SMSActivateGetPriceInfo vk=smsActivateGetPricesResponse.getPriceInfo(0, "vk");//Getting information about the Vkontakte service for Russia
System.out.println(">>> Cost: "+ vk.getCost());//Get a price for the service System.out.println(">>> count phone numbers: " + vk.getCountPhoneNumbers());//Get the number of numbers for the service
SMSActivateActivation activation=smsActivateApi.getNumber(0,"vk")//Get activation for the Vkontakte service in Russia System.out.println(activation);//Withdraw the received activation SMSActivateGetStatusResponse getResponse = smsActivateApi.getStatus(activation);//Getting a status for activation
System.out.println(getResponse.getSMSActivateGetStatus());//Displaying information about the activation status
smsActivateApi.setStatus(activation, SMSActivateClientStatus.MESSAGE_WAS_SENT);//Setting the MESSAGE_WAS_SENT status after receiving SMS for the number
smsActivateApi.setStatus(activation, SMSActivateClientStatus.FINISH);//Setting the FINISH status after receiving SMS for the number
SMSActivateGetCountriesResponse smsActivateGetCountriesResponse =smsActivateApi.getCountries();//Getting a list of countries with information SMSActivateCountryInfo countryInfo = smsActivateGetCountriesResponse.get(0)//Getting information about the first country on the list
System.out.println("Russian name: "+countryInfo.getRussianName();//Display the Russian name of the country System.out.println("English name: "+countryInfo.getEnglishName();//Display the Russian name of the country System.out.println("Support multi-service: "+ countryInfo.isSupportMultiService() ? "yes" : "no"//Show if the country supports multi-services
SMSActivateActivation activation=smsActivateApi.getNumber(0,"vk")//Get activation for the Vkontakte service in Russia smsActivateApi.setStatus(activation, SMSActivateClientStatus.MESSAGE_WAS_SENT);//Setting the MESSAGE_WAS_SENT status after sending SMS for the number String code=smsActivateApi.waitSms(activation,2)//Set receiving sms within 2 minutes if(code == null) { smsActivateApi.setStatus(activation, SMSActivateClientStatus.CANCEL);//Setting the CANCEL status if sms has not arrived }
else{
SMSActivateGetFullSmsResponse smsActivateGetFullSmsResponse=smsActivateApi.getFullSms(activation)//Receiving sms text System.out.println("Full SMS: "+smsActivateGetFullSmsResponse.getText());//SMS text output }
SMSActivateRentActivation rentActivation= smsActivateApi.getRentNumber(0, "vk", 6);//Getting a number with rent System.out.println(">> ID: "+rentActivation.getId());//Activation ID withdrawal System.out.println(">> Number: "+rentActivation.getId());//Displaying the activation number System.out.println(">> End date: "+rentActivation.getId());//Displaying the activation expiration date SMSActivateGetRentServicesAndCountriesResponse smsActivateGetRentServicesAndCountriesResponse= smsActivateApi.getRentServicesAndCountries(0, null, 4);//Obtaining information on services and countries that support rental
smsActivateGetRentServicesAndCountriesResponse.getAllRentServices().forEach((serviceShortName, smsActivateRentService)->{ System.out.println("Service shortname: " + serviceShortName);
System.out.println(" count phone numbers: " + smsActivateRentService.getCountPhoneNumbers());
System.out.println(">> Cost: " + smsActivateRentService.getCost()); }
//Displaying information about received services
SMSActivateRentActivation rentActivation= smsActivateApi.getRentNumber(0, "vk");//Getting a number with rent SMSActivateGetRentStatusResponse smsActivateGetRentStatusResponse= smsActivateApi.getRentStatus(rentActivation);//Getting activation status System.out.println(">> Count sms: "+ smsActivateGetRentStatusResponse.getCountSms());//Displaying the number of sms on the rented number

{{ texts.verificationVoiceTextFirst }}

{{ texts.verificationVoiceTextSecond }}

{{ texts.verificationVoiceTextThird }}