Dimar FZC LLC
Flamingo Villas A-32-01-05-03 25314 Araabia Ühendemiraadid, Ajman
+971585072431, /assets/img/icons/logo/logo.svg, [email protected]

API protokoll tööks SMS-Activate'iga

API on protokoll teie tarkvara ja meie serveri vahel

API-d on vaja SMS-i, OTP ja PVA vastuvõtmise protsessi automatiseerimiseks teie poolel

Meie API on täielikult ühilduv konkurentide saitidega

Kõik päringud tuleb saata aadressile https://api.sms-activate.ai/stubs/handler_api.php

POST- või GET-päring.

Kõik päringud peavad sisaldama API-võtit parameetri api_key kujul GET-päringus

Laadi alla protokolli PHP-teostus Laadi alla valmis Pythoni protokolli teostus

Aktiveerimise API

Päring saadaolevate virtuaalsete numbrite koguse kohta
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country&operator=$operator

Parameetrid:

$api_key - API võti

$country * - riigi number vaata tabelit

$operaator * mobiilioperaatorite numbrid, saate määrata mitu numbrit, eraldatuna komadega (saadaval ainult:

Venemaa
megafon, mts, beeline, tele2, rostelecom, any
Ukraina
kyivstar, life, utel, mts, vodafone
Kasahstan
tele2, beeline, activ, altel

** saadaval riigis $country = 0, $country = 1, $country = 2

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

{"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}
Kriipsu ees on teenuse nimi, pärast märgistust on näidatud, kas ümbersuunamine on vajalik. 0 – ei, 1 – jah.

Täielik teenuste loend

Päring teenuse põhiste tippriikide kohta FreePrice
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getTopCountriesByService&service=$service&freePrice=$freePrice

Parameetrid:

$api_key - API võti

$service * - Teenus vaata tabelit

* valikuline parameeter. Kui seda ei ole määratud, kuvatakse vaikimisi kõigi teenuste populaarseimad riigid.

$freePrice * - valikuline parameeter. Kui see on esitatud true, kuvatakse kogus ja hind vastavalt Free Price’ile

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

{ 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 } }, ... }
Saldo päring
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getBalance

Konto jäägi päring koos cashback’iga:

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

* tagastab jäägi, võttes arvesse kogunenud cashback’i, kui cashback’i konto seadetes on linnuke „Kasuta cashback’i aktiveerimisel“ märgitud

Parameetrid:

$api_key - API võti

VASTUS:

ACCESS_BALANCE: „konto jääk“

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

ERROR_SQL - SQL-serveri viga

Päring saadaolevate operaatorite kohta
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getOperators&country=$country

* tagastab kõik edastatud riigis saadaval olevad operaatorid; kui riiki ei ole edastatud, tagastatakse kõik igas riigis saadaval olevad operaatorid

Parameetrid:

$api_key - API võti

$country - riigikood

VASTUS:

Teenuse vastus on JSON-vormingus:

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

Näide:

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

* sees 'countryOperators' – võtmeks on riigikood

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

ERROR_SQL - SQL-serveri viga

OPERATORS_NOT_FOUND - kirjeid ei leitud (nt edastati olematu riik)

Päring aktiivsete aktiveerimiste kohta
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getActiveActivations

Parameetrid:

$api_key - API võti

VASTUS:

Teenuse vastus on JSON-vormingus:

{"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",
}]

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

ERROR_SQL - SQL-serveri viga

NO_ACTIVATIONS - kirjeid ei leitud (aktiivseid aktiveerimisi pole)

Numbri tellimine 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

Parameetrid:

$api_key - API võti

$service - tellimise teenus vaata tabelit

$forward * - kas on vaja taotleda numbrit koos ümbersuunamisega

* valikuline parameeter, väärtused: 0 (ära tee, vaikimisi), 1 (tee)

$maxPrice * - maksimaalne hind, mille oled nõus maksma numbri eest Free Price’ga

* valikuline parameeter; kui seda ei ole määratud, toimub ost tavalise hinnaga

$phoneException * - Venemaa numbrite eesliidete välistamine. Sisesta komaga eraldatult. Kirje vorming: riigikood ja 3–6 maski numbrit (nt 7918, 7900111). Vaikimisi väärtus on kontol määratud väärtus.

$operaator* on numbri mobiilioperaator, saate määrata mitu operaatorit komaga eraldatuna (saadaval ainult ** jaoks)

$aktivatsiooniTüüp - aktivatsiooni tüüp: 0 - SMS-iga (vaikimisi), 1 - numbriga, 2 - häälkõnega

$keel - parsimise keel (nõutav häälaktivatsiooni korral) vaata tabelit

$kasutajaId * - kasutaja ID, kellele määratakse blokeering halva aktivatsioonistatistika tõttu, edasimüüja enda kontot see ei mõjuta.

Venemaa
megafon, mts, beeline, tele2, rostelecom, any
Ukraina
kyivstar, life, utel, mts, vodafone
Kasahstan
tele2, beeline, activ, altel

* valikuline väli

** saadaval riigis $country = 0, $country = 1, $country = 2

$viide - edasta viite ID.

$country - riigi number vaata tabelit

$kasutaTagasimakset* - võtab loogilise väärtuse; kui parameeter on 'true', sooritatakse numbri ost kasutades tagasimakseid. Kui tagasimaksete saldo saab tühjaks, tehakse kõik järgnevad ostud põhisisaldelt. On OLULINE meeles pidada, et kõik järgnevad ostud kasutavad esmalt tagasimakseid ja alles seejärel põhisisaldet (isegi kui hiljem edastada parameeter 'false').

* valikuline parameeter, aktsepteerib väärtust 'true'

API kaudu numbri hankimisega nõustute projekti reeglid projekti reeglid

VÕIMALIKUD VEAD:

VALE_MAX_HIND:$min- määratud maksimaalne hind on väiksem kui lubatud

$min - minimaalne lubatud hind

HALB_TEGEVUS - vale tegevus

HALB_TEENUS - vale teenuse nimi

BAD_KEY - vigane API-võti

ERROR_SQL - SQL-serveri viga

BLOKEERITUD:'YYYY-m-d H-i-s' - aeg, milleks konto on blokeeritud

VALE_ERANDI_EESLIIDE - valed erandi eesliited

PUUDUB_SALDO_EDASTAMISEKS - ebapiisavad vahendid kõne suunamise ostmiseks

KANALITE_PIIRANG - konto blokeeritud

NUMBREID_POLE - numbreid pole

Kui proovite hankida kindla operaatori numbri, kes ei tegutse valitud riigis või kes ei paku valitud teenust, tagastatakse esimese sobiva operaatori number vastavalt päringu parameetritele

V2 Numbripäring 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

meetod töötab sarnaselt meetodile getNumber, aktsepteerib samu parameetreid ja allpool kirjeldatud lisaparameetreid, kuid tagastab täiendavat aktivatsiooniinfot

Parameetrid:

$tellimuseId- aktivatsiooni ID edasimüüja süsteemis. Ostude ajal võrreldakse neid andmeid meie süsteemi aktivatsiooni ID ja edasimüüjaga. Seega püüame saavutada idempotentsust (sama tellimust ei töödelda uuesti).

VASTUS:

Kui päring õnnestub, on vastus järgmises vormingus:

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

Kui proovite hankida kindla operaatori numbri, kes ei tegutse valitud riigis või kes ei paku valitud teenust, tagastatakse esimese sobiva operaatori number vastavalt päringu parameetritele

VÕIMALIKUD VEAD:

ORDER_ALREADY_EXISTS- tellimus on juba loodud

Veebikonksud

Kui saate numbrile SMS-i ja olete seadetes lubanud Webhooksi funktsiooni, saadame teie määratud aadressidele SMS-i teabe POST-päringu kaudu.

VASTUS:

Vastuse vorming on järgmine:

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

Päringu saatmisel ootame teie skriptilt vastust HTTP staatusega 200. Kui teie skript ei vasta, saadame päringu uuesti 2 tunni jooksul, kuid mitte rohkem kui 8 korda.

Selle funktsiooni saate lubada profiili seadetes

Virtuaalse numbri tellimine mitmele teenusele
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

Parameetrid:

$api_key - API võti

$service - tellimise teenus vaata tabelit

$forward * - kas on vaja taotleda numbrit koos ümbersuunamisega

* valikuline parameeter, edastatavad märgid eraldatakse komadega; edastatavate numbrite arv peab vastama parameetris edastatud teenuste arvule $service. Lubatud on edastada ainult ühte teenust suunamisega, näiteks "0,1,0,0" on korrektne, "0,1,1,0" on vale. Kasutatakse väärtusi 0 (ära täida, vaikimisi) ja 1 (täida)

$operaator * - numbri mobiilsideoperaator, saate määrata mitu operaatorit, eraldades need komadega (saadaval ainult ** jaoks):

Venemaa
megafon, mts, beeline, tele2, rostelecom, any
Ukraina
kyivstar, life, utel, mts, vodafone
Kasahstan
tele2, beeline, activ, altel

$viide - edasta viite ID.

$country - riigi number vaata tabelit

API kaudu numbri hankimisega nõustute projekti reeglid projekti reeglid

VASTUS:

NUMBREID_POLE - numbreid pole

NO_BALANCE - saldo on otsas

{{'phone':phone,'activation':activation,'service':service},
{'phone':phone,'activation':activation,'service':service}}
, kus (phone - operatsiooni ID, activation - telefoninumber, service - teenus)

VÕIMALIKUD VEAD:

HALB_TEGEVUS - vale tegevus

HALB_TEENUS - vale teenuse nimi

BAD_KEY - vigane API-võti

ERROR_SQL - SQL-serveri viga

BLOKEERITUD:'YYYY-m-d H-i-s' - aeg, milleks konto on blokeeritud

Aktiveerimise staatuse muutmine
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id&forward=$forward

Parameetrid:

$api_key - API võti

$id - aktiveerimise ID

$forward * - telefoninumber, millele soovite suunata

* nõutav ainult siis, kui parameeter edastati kujul getNumber forward=1.

$status - aktiveerimise staatus

1 - teavita numbri saadavusest (numbrile on saadetud SMS)

3 - taotle veel üks kood (tasuta)

6 - lõpeta aktiveerimine *

8 - teata, et number on juba kasutatud, ja tühistada aktiveerimine

* kui oleks staatus 'kood saadud' - märgib selle edukaks ja lõpetab; kui oleks 'ettevalmistus' - kustutab ja märgib veaks; kui oleks staatus 'ootab korduskatset' - viib aktiveerimise ootel SMS-ide hulka

** Ei ole võimalik muuta aktiveerimise staatust, mille puhul on valitud kinnitamismeetodiks kõne, kui number on juba saabunud

API-ga töötamise kronoloogia lihtne loogika:

Numbri hankimine meetodi getNumber abil, seejärel on saadaval järgmised toimingud:

8 - tühistada aktiveerimine (kui number ei sobi)

1 - teavitada, et SMS on saadetud (valikuline)

Aktiveerimisele staatusega 1:

8 - tühistada aktiveerimine

Vahetult pärast koodi saamist:

3 - taotle veel üks SMS

6 - kinnita SMS-kood ja lõpeta aktiveerimine

Aktiveerimisele staatusega 3:

6 - kinnita SMS-kood ja lõpeta aktiveerimine

VASTUS:

ACCESS_READY - numbrite valmidus kinnitatud

ACCESS_RETRY_GET - ootab uut SMS-i

ACCESS_ACTIVATION - teenus on edukalt aktiveeritud

ACCESS_CANCEL - aktiveerimine tühistatud

VÕIMALIKUD VEAD:

EARLY_CANCEL_DENIED - numbri tühistamine esimese 2 minuti jooksul ei ole lubatud

ERROR_SQL - SQL-serveri viga

NO_ACTIVATION - aktiveerimise ID-d ei eksisteeri

HALB_TEENUS - vale teenuse nimi

BAD_STATUS - vale staatus

BAD_KEY - vigane API-võti

HALB_TEGEVUS - vale tegevus

WRONG_ACTIVATION_ID - vale ID või ID ei ole arv.

Aktiveerimise staatuse hankimine
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

Parameetrid:

$api_key - API võti

$id - aktiveerimise ID

VASTUS:

STATUS_WAIT_CODE - ootab SMS-i

STATUS_WAIT_RETRY: 'minevik, sobitamata kood' - ootab koodi täpsustamist

STATUS_WAIT_RESEND - ootab SMS-i uuesti saatmist *

* tarkvara peab vajutama SMS-i uuesti saatmise nuppu ja muutma staatuseks 6

STATUS_CANCEL - aktiveerimine tühistatud

STATUS_OK: 'aktiveerimiskood' - kood saadud

VÕIMALIKUD VEAD:

NO_ACTIVATION - aktiveerimise ID-d ei eksisteeri

ERROR_SQL - SQL-serveri viga

BAD_KEY - vigane API-võti

HALB_TEGEVUS - vale tegevus

Aktiveerimise staatuse hankimine, versioon 2
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getStatusV2&id=$id

Parameetrid:

$api_key - API võti

$id - aktiveerimise ID

VASTUS:

Vastuse vorming on järgmine:

{
"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 - aktiveerimine tühistatud

VÕIMALIKUD VEAD:

NO_ACTIVATION - aktiveerimise ID-d ei eksisteeri

ERROR_SQL - SQL-serveri viga

BAD_KEY - vigane API-võti

HALB_TEGEVUS - vale tegevus

Aktiveerimise ajaloo hankimine
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getHistory&start=$start&end=$end&offset=$offset&limit=$limit

Parameetrid:

$api_key - API võti

$start - ajatempel Unix Timestamp formaadis (valikuline) - millise kuupäevaga alates aktiveerimisi arvestada

$end - ajatempel Unix Timestamp formaadis (valikuline) - millise kuupäevani aktiveerimisi arvestada

$offset - vastuses tagastatava esimese elemendi nihe. Vaikimisi on 0

$limit - maksimaalne tagastatavate kirjete arv. Maksimum on 100. Vaikimisi on 50.

VASTUS:

Vastuse vorming on järgmine:

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

VÕIMALIKUD VEAD:

ERROR_SQL - SQL-serveri viga

BAD_KEY - vigane API-võti

HALB_TEGEVUS - vale tegevus

TOP 10 riigi hankimine teenuse kaupa
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getListOfTopCountriesByService&service=$service

Parameetrid:

$api_key - API võti

$service - teenuse nimi

VASTUS:

Vastuse vorming on järgmine:

[{
"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)
}]

VÕIMALIKUD VEAD:

ERROR_SQL - SQL-serveri viga

BAD_KEY - vigane API-võti

WRONG_SERVICE - vale teenus

HALB_TEGEVUS - vale tegevus

Sissetuleva kõne staatuse hankimine
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getIncomingCallStatus&activationId=$id

Parameetrid:

$api_key - API võti

$id - aktiveerimise ID

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

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

VÕIMALIKUD STAATUSED:

2 - uus aktiveerimine

3 - edukalt lõpetatud

4 - tühistatud

5 - tagastatud

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

INVALID_ACTIVATION_ID - Vigane aktiveerimise ID

Kehtivate hindade hankimine riikide kaupa
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

Parameetrid:

$api_key - API võti

$serviceTeenuse lühinimi (valikuline, vaikimisi kõik teenused) vaata tabelit

$countryRiigikoodi nimi (valikuline, vaikimisi kõik riigid) vaata tabelit

VASTUS:

JSON - objekt formaadis
{"Country":{"Service":{"cost":Cost,"count":Count}}}

Ajakohaste hindade hankimine kinnitusteenustele
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getPricesVerification&service=$service

Parameetrid:

$api_key - API võti

$serviceTeenuse lühinimi (valikuline, vaikimisi kõik teenused) vaata tabelit

VASTUS:

JSON - objekt formaadis
{"Service":{"Country":{"count":Quantity,"price":"Price"}}}

Kõikide riikide loendi hankimine
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getCountries

Parameetrid:

$api_key - API võti

VASTUS:

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

kus (

id : riigi ID;

rus : riigi nimi vene keeles;

eng : riigi nimi inglise keeles;

chn : riigi nimi hiina keeles;

visible : 0 - riiki ei kuvata saidil, 1 - kuvatakse;

retry : 0 - korduv SMS EI ole saadaval, 1 - saadaval;

rent : 0 - riik ei ole renditav, 1 - renditav;

multiService : 0 - riik EI ole saadaval multiteenuse jaoks, 1 - saadaval.)

Kõikide teenuste loendi hankimine
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getServicesList

Parameetrid:

$api_key- API võti

$country *- Riigi ID. Kui olete edastanud riigi, tagastame teenused, millel on valitud riigi hind

$lang *- millist keelt kasutada `name` väljastamiseks. Võimalikud väärtused: 'ru', 'en', 'es', 'cn'. Vaikimisi on 'en'

* valikuline parameeter

VASTUS:

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

Lisateenus ümbersuunatud numbritele

Kui olete saanud esimese SMS-i ümbersuunatud numbritele, saate osta muid seotud teenuseid, nagu Yula, Yandex, Avito või muud

Lisateenuse hind on vaid 5p

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

Parameetrid:

$api_key - API võti

$service - teenuse lühinime leiate tabelist vaata tabelit

$id - Ülemaktiveerimise ID

VASTUS:

ADDITIONAL:$id:$phone - uus aktiveerimine loodi edukalt. Kus ID on lisaktiveerimise ID ja phone on telefoninumber

VÕIMALIKUD VEAD:

WRONG_ADDITIONAL_SERVICE - Vigane lisateenus (lubatud on ainult edastamisteenused)

WRONG_ACTIVATION_ID - Vale ülemaktiveerimise ID

WRONG_SECURITY - viga ilmnes aktiveerimis-ID edastamisel ilma ümbersuunamiseta või juba lõpetatud/mitteaktiivse aktiveerimise korral

REPEAT_ADDITIONAL_SERVICE - viga tekib juba ostetud teenuse uuesti tellimisel NO_BALANCE - Ebapiisav saldo

ERROR_SQL- andmebaasi viga, võtke ühendust klienditoega

Virtuaalse numbri taasaktiveerimine

Kui olete numbril edukalt aktiveerinud, saate seda teha uuesti.

Lisaktiveerimise hind sõltub riigist ja teenusest. Täpse hinna saate pärida lehelt .

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

Parameetrid:

$api_key - API võti

$activationId - Ülemaktiveerimise ID

VASTUS:

ACCESS_NUMBER:$id:$phone - uus aktiveerimine loodi edukalt. Kus $id on lisaktiveerimise ID ja $phone on telefoninumber

VÕIMALIKUD VEAD:

RENEW_ACTIVATION_NOT_AVAILABLE- number ei ole lisaktiveerimiseks saadaval

WRONG_ACTIVATION_ID - Vale ülemaktiveerimise ID

ERROR_SQL- andmebaasi viga, võtke ühendust klienditoega

NEW_ACTIVATION_IMPOSSIBLE- lisaktiveerimine ei ole võimalik

NO_BALANCE - kontol pole raha

Hankige lisaknumbri aktiveerimise hind

Saate kontrollida numbri saadavust lisaktiveerimiseks ja saada selle hinna

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

Parameetrid:

$api_key - API võti

$activationId - Ülemaktiveerimise ID

VASTUS:

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

VÕIMALIKUD VEAD:

RENEW_ACTIVATION_NOT_AVAILABLE- number ei ole lisaktiveerimiseks saadaval

WRONG_ACTIVATION_ID - Vale ülemaktiveerimise ID

SIM_OFFLINE - SIM-kaart on offline

Korduv häälsõnumite töötlemine
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=parseCall&id=$id&newLang=$newLang

Parameetrid:

$api_keyAPI-võti

$id - aktiveerimise ID

$newLang - uus parsimiskeel vaata tabelit

VASTUS:

Vastuse vorming on järgmine:

{
"result": "OK"
}

STATUS_CANCEL - aktiveerimine tühistatud

NO_CALL- kõnet ei saadud

PARSE_COUNT_EXCEED- päringute piirang (maksimaalselt 4)

VÕIMALIKUD VEAD:

WRONG_ACTIVATION_ID - vigane ID, aktivatsiooni ei eksisteeri

ERROR_SQL - SQL-serveri viga

BAD_KEY - vigane API-võti

HALB_TEGEVUS - vale tegevus

API rentimine

Saadaolevate riikide ja teenuste päring
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getRentServicesAndCountries&rent_time=$time&operator=$operator&country=$country&incomingCall=$incomingCall

Parameetrid:

$api_key - API võti

$time* - rendi aeg (vaikimisi: 4 tundi)

$operaator* - numbri mobiilioperaator, saab määrata mitu, eraldatud komadega (vaikimisi: Suvaline)

$country* - riik (vaikimisi: Venemaa)

$incomingCall * - kui edastatakse "true"saada number, mis toetab kõne vastuvõtmise funktsiooni

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

{ "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 } } }

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

OUT_OF_STOCK - selle riigi numbrid pole saadaval

Virtuaalse numbri rendi tellimine
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

Parameetrid:

$api_key - API võti

$service - teenus, mille jaoks peate numbri hankima

$time* - rendi aeg tundides (vaikimisi: 4 tundi). Järgmine võimalik ajavahemik on 12 tundi, seejärel 24 tundi. Päevase või pikema rendi tellimisel tuleb edastada: 24, 48, 72 jne.

$operaator* - numbri mobiilioperaator, saab määrata mitu, eraldatud komadega (vaikimisi: Suvaline)

$country* - riik (vaikimisi: Venemaa)

$url * - veebihaagi link (vaikimisi ei arvestata)

$incomingCall * - kui edastatakse "true"saada number, mis toetab kõne vastuvõtmise funktsiooni

Mis on webHook?

* valikuline parameeter. Kui määramata, kasutatakse vaikimisi parameetrit.

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

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

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

Vasta json-vormingus:

{ "status": "error", "message": "*võimalik_vastus*" }


Välja võimalikud vastused "message":

HALB_TEENUS - teenus pole määratud või nimi on vale

NO_BALANCE - kontol pole raha

NUMBREID_POLE - numbreid pole

ACCOUNT_INACTIVE - numbreid pole

SERVER_ERROR - serveri viga

KANALITE_PIIRANG - konto blokeeritud

Rendi staatuse hankimine
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getRentStatus&id=$id&page=$page&size=$size

Parameetrid:

$api_key - API võti

$id - Renditud ID, mis saadi vastuses numbri tellimisel

$page* - lehe number, millest valik algab (lehtede nummerdamine algab 0-st, uutest vanadeni; vaikimisi on 0)

$size* - lehe suurus (vaikimisi 10)

* valikuline parameeter. Kui määramata, kasutatakse vaikimisi parameetrit.

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

{ "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" } } }

* õnnestub ainult siis, kui SMS on olemas (välja 'quantity' > 0).

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

Vasta json-vormingus:

{ "status": "error", "message": "*võimalik_vastus*" }

Välja võimalikud vastused "message":

NO_ID_RENT - rendi ID pole määratud

INVALID_PHONE - number ei ole teie poolt renditud (vigane rendi ID)

STATUS_FINISH - rent on makstud ja lõpetatud

STATUS_CANCEL - rent on tühistatud koos tagasimaksega

STATUS_WAIT_CODE - ootab esimest SMS-i

STATUS_REVOKE - number on blokeeritud, teie vahendid on tagastatud

Rendi staatuse muutmine
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=setRentStatus&id=$id&status=$status

Parameetrid:

$api_key - API võti

$id - Renditud ID, mis saadi vastuses numbri tellimisel

$status - staatuse muutmise kood (number)

Staatus võib olla:

1
Lõpeta
2
Tühista

VASTUS:

Teenuse vastus on JSON-vormingus:

{ "status": "success" }

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

Vasta json-vormingus:

{ "status": "error", "message": "*võimalik_vastus*" }

Välja võimalikud vastused "message":

NO_ID_RENT - rendi ID pole määratud

INCORECT_STATUS - puuduv või valesti määratud staatus

CANT_CANCEL - renti ei saa tühistada (rohkem kui 20 min.)

INVALID_PHONE - number ei ole teie poolt renditud (vigane rendi ID)

ALREADY_FINISH - rent on juba lõpetatud

ALREADY_CANCEL - rent on juba tühistatud

SERVER_ERROR - serveri viga

Praeguste aktiveerimiste loend
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getRentList

👉Tähelepanu! See meetod kuvab ainult viimased 10 numbrit. Kui vajate rohkem numbreid, kasutage getRentStatus meetodit staatuste kontrollimiseks.

Parameetrid:

$api_key - API võti

VASTUS:

Teenuse vastus on JSON-vormingus:

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

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

HALB_TEGEVUS - vale tegevus


Vasta json-vormingus:

{ "status": "error", "message": "*võimalik_vastus*" }


Välja võimalikud vastused "message":

NUMBREID_POLE - renditud numbreid pole

SERVER_ERROR - serveri viga

Pikenda oma rendiperioodi
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=continueRentNumber&id=$id&rent_time=$time

Parameetrid:

$api_key - API võti

$id - rendi id

$rent_time- rendi aeg (vaikimisi: 4 tundi)

VASTUS:

Teenuse vastus on JSON-vormingus:

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

Kui lõpetatud renti pikendatakse, tellitakse see uuesti ja väljastatakse uus id

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

HALB_TEGEVUS - vale tegevus

SERVER_ERROR - serveri viga


Vasta json-vormingus:

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


Välja võimalikud vastused "message":

NO_ID_RENT - rendi ID-d pole

INVALID_TIME - vale aeg. Saadaval on 4 kuni 1344 tundi

MAX_HOURS_EXCEED - Maksimaalne lubatud aeg on ületatud

info:

max - maksimaalne lubatud aeg

INVALID_PHONE - vigane rendi ID

RENT_DIE - rentimist ei saa pikendada, kuna number on aegunud

NO_BALANCE - ebapiisav vahendite hulk

KANALITE_PIIRANG - konto blokeeritud

Rendi pikendamise hinna hankimine
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getContinueRentPriceNumber&id=$id&rent_time=$time

* see meetod on saadaval ainult MTT operaatoriga rentimisel.

Parameetrid:

$api_key - API võti

$id - rendi id

$rent_time - rentimise aeg

VASTUS:

Teenuse vastus on JSON-vormingus:

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

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

HALB_TEGEVUS - vale tegevus

SERVER_ERROR - serveri viga


Vasta json-vormingus:

{ "status": "error", "message": "*võimalik_vastus*" }


Välja võimalikud vastused "message":

NO_ID_RENT - rendi ID-d pole

INVALID_PHONE - vigane rendi ID

INVALID_TIME - vale ajaseade

RENT_DIE - rentimist ei saa pikendada, kuna number on aegunud

MAX_HOURS_EXCEED - Maksimaalne lubatud aeg on ületatud

info:

max - maksimaalne lubatud aeg

KANALITE_PIIRANG - konto blokeeritud

API JAVA

Töö alustamine

Lisa teek Mavenisse

<sõltuvus><groupId>ru.sms-activate</groupId>
<artifactId>SMSActivateApi</artifactId>
<version>1.0</version>
</sõltuvus>

Näidet registreerimisest näed lingil MavenRepository

Impordi põhiklass SMS-Activate API-ga suhtlemiseks.

import ru.sms_activate.SMSActivateApi

Teegi kasutamiseks on vaja API-võtit, mille saad sellel lehel ja alloleval lingil.

SMS-Activate API-võti
Näide saldo kasutamisest

Konto praeguse saldo kuvamiseks kasuta meetodit getBalance... Kui sind huvitab lisaks saldole ka sularaha tagasimakse, siis kutsu meetodit getBalanceAndCashBack.

Meetod getBalanceAndCashBack tagastab klassi objektiSMSActivateGetBalanceAndCashBack.

getBalance: Hangi konto praegune saldo

Parameetrid:

PUUDUB

TAGASTUSTÜÜP:

BigDecimal

getBalanceAndCashBack: Hangi saldo ja sularaha tagasimakse summa kui täissaldo

Parameetrid:

PUUDUB

getNumber: Hangi aktiveerimine

Parameetrid:

countryId(Integer) - riigi identifikaator.

service(String) - teenuse lühinimi.

forward*(boolean) - kas taotleda numbrit kõne suunamisega.

operaatoriteHulk*(Hulk) - operaatorite hulk.

telefonierand*(Hulk) - välja arvatud ainult Venemaa eesliited, numbrite hulk vahemikus 3 kuni 6 (7918,7900111).

* valikuline väli. Kui midagi pole määratud, antakse vaikimisi kogus vastavalt profiili seadistusele.

TAGASTUSTÜÜP:

SMSActivateActivation

getNumberStatus: Hangi teave saadaolevate teenuste kohta

Parameetrid:

countryId(Integer) - riigi identifikaator.

operaatoriteHulk*(Hulk) - teenuse jaoks saadaval olevate operaatorite hulk

TAGASTUSTÜÜP:

SMSActivateGetNumbersStatus

getAdditionalService: Tagastab kõnesuunamisnumbri lisateenuse.

Parameetrid:

id(Täisarv) - aktiveerimise identifikaator

service(String) - teenuse lühinimi.

Aktiveerimise identifikaatori asemel võite edastada saadud klassiobjekti SMSActivateActivation pärast meetodi kasutamist getNumber või üks aktiveerimistest pärast kasutamist getMultiServiceNumber.

TAGASTUSTÜÜP:

SMSActivateGetNumbersStatus

getMultiServiceNumber: Hanki aktiveerimine mitmele teenusele

Parameetrid:

countryId(Integer) - riigi identifikaator.

teenusteKaart(Hulk) - teenuste hulk, mille jaoks aktiveerimine on ostetud

multiSuunamiseLoend(Loend) - loend teenustest, millel on kõnesuunamine saadaval

operaatoriteHulk(Hulk) - operaatorite hulk.

getAllPrices: Hangi täielik nimekiri aktiveerimishindadest

Parameetrid:

PUUDUB

TAGASTUSTÜÜP:

SMSActivateGetPriceInfo

getPricesByCountryIdAndServiceShortName: Hangi riigi ja teenuse põhjal aktiveerimishindade nimekiri

Parameetrid:

countryId(Integer) - riigi identifikaator.

service(String) - teenuse lühinimi.

TAGASTUSTÜÜP:

SMSActivateGetPriceInfo

getPricesAllServicesByCountryId: Hangi riigi põhjal aktiveerimishindade nimekiri

Parameetrid:

countryId(Integer) - riigi identifikaator.

TAGASTUSTÜÜP:

SMSActivateGetPriceInfo

getStatus: Hangi aktiveerimise staatus

Parameetrid:

aktiveerimiseId(Täisarv) - aktiveerimise identifikaator

Aktiveerimise identifikaatori asemel võite edastada saadud klassiobjekti SMSActivateActivation pärast meetodi kasutamist getNumber või üks aktiveerimistest pärast kasutamist getMultiServiceNumber.

setStatus: Määra aktiveerimise staatus

Parameetrid:

id(Täisarv) - aktiveerimise identifikaator

staatus(SMSActivateClientStatus) - staatus, mis tuleb aktiveerimisele määrata

Aktiveerimise identifikaatori asemel võite edastada saadud klassiobjekti SMSActivateActivation pärast meetodi kasutamist getNumber või üks aktiveerimistest pärast kasutamist getMultiServiceNumber.

getCountries: Hangi teave riikide kohta

Parameetrid:

PUUDUB

getFullSms: Hangi numbri SMS-i täistekst

Parameetrid:

aktiveerimiseId(Täisarv) - aktiveerimise identifikaator

Aktiveerimise identifikaatori asemel võite edastada saadud klassiobjekti SMSActivateActivation pärast meetodi kasutamist getNumber või üks aktiveerimistest pärast kasutamist getMultiServiceNumber.

Algoritm SMS-i täisteksti saamiseks aktiveerimisega

Numbri hankimine meetodi getNumber abil, seejärel on saadaval järgmised toimingud:

CANCEL - 8 - Tühista aktiveerimine (kui number ei sobi)

MESSAGE_WAS_SENT - Teavita, et SMS on saadetud (kohustuslik SMS-i täisteksti saamiseks)

Pärast kohustusliku MESSAGE_WAS_SENT staatuse määramist seadke muutuja SMS-i vastuvõtmiseks, kasutades meetodit waitSMS koos aktiveerimisparameetrite ja SMS-i ooteajaga.

Pärast SMS-i kättesaamist saate selle hankida meetodiga getFullSMS ja seejärel kuvada täisteksti meetodiga getText().

Seejärel saate määrata aktiveerimised järgmistesse olekutesse:

Aktiveerimiseks olekuga MESSAGE_WAS_SENT:

CANCEL - Tühista aktiveerimine

Vahetult pärast koodi saamist:

REQUEST_ONE_MORE_CODE - Taotle teist SMS-i

FINISH - Kinnita SMS-kood ja lõpeta aktiveerimine

Aktiveerimiseks olekuga REQUEST_ONE_MORE_CODE:

FINISH - Kinnita SMS-kood ja lõpeta aktiveerimine

getRentNumber: Hangi number rendivõimalusega

Parameetrid:

countryId(Integer) - riigi identifikaator.

service(String) - teenuse lühinimi.

hours(Integer)* - rendi aeg

operator(String)* - mobiilioperaatori nimi

urlWebhook(String)* - veebihaagi link (vaikimisi ei arvestata)

Mis on webHook?

* valikuline parameeter. Kui pole määratud, on vaikimisi väärtus

TAGASTUSTÜÜP:

SMSActivateRentActivation

GetRentServicesAndCountriesRun: Hangi teenused ja riigid rendiks

Parameetrid:

countryId(Integer) - riigi identifikaator.

operaatoriteHulk(Hulk) - mobiilioperaatorite komplekt

hours(Integer)* - rendi aeg

* valikuline parameeter. Kui pole määratud, on vaikimisi väärtus

GetRentStatusJava: Hangi rendi staatus

Parameetrid:

rentId(Integer) - renditud numbri identifikaator

rentId asemel saate edastada saadud klassi objekti SMSActivateRentActivation pärast meetodi kasutamist getRentNumber

TAGASTUSTÜÜP:

SMSActivateRentStatus

E-posti API

API olekute kirjeldus

3 - Ootel

4 - Tühistatud

5 - Õnnestunud

Posti API, versioon 2

KIRJELDUS:

REST API põhimõtete rangem järgimine ja suurem arv gmail.com postkaste Telegrami kontode registreerimiseks.

Pakkumiste loendi hankimine
https://api.sms-activate.ai/stubs/handler_api.php?action=getDomains&api_key=$api_key&site=$site

Parameetrid:

$api_key - API võti

$site- sait, mille jaoks vajate e-posti aadressi

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

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

VÕIMALIKUD VEAD:

BAD_SITE- Saiti pole määratud

BAD_KEY - vigane API-võti

HALB_TEGEVUS - vale tegevus

Osta e-posti kinnitus
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

Parameetrid:

$api_key - API võti

$site - sait, mille jaoks vajate e-posti aadressi

$mail_type - postitüüp: populaarsed domeenid või tsoonid (1 - tsoonid, 2 - populaarsed)

$mail_domain - valitud tsoon või domeen

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

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

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

HALB_TEGEVUS - vale tegevus

MAIL_TYPE_ERROR - määratud saidi jaoks sellist domeeni ei ole

KANALITE_PIIRANG - konto blokeeritud

E-posti taasaktiveerimine
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=reorderMailActivation&id=$id

Parameetrid:

$api_key - API võti

$id- E-posti ID, mille taasaktiveerimine on vajalik

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

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

VÕIMALIKUD VEAD:

BAD_KEY - vigane API-võti

HALB_TEGEVUS - vale tegevus

BLOCKED_SITE - blokeeritud veebisait

BAD_BALANCE - ebapiisav vahendite hulk

ACTIVATION_NOT_FOUND - aktiveerimist ei leitud

KANALITE_PIIRANG - konto blokeeritud

Aktiivsete ostude loendi hankimine
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

Parameetrid:

$api_key - API võti

$page- lehe number

$per_page- ostude arv ühel lehel

$search- otsinguriba

$sort- sorteerimise suund (desc, asc)

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

{
                        "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
                        }
                        }
Tühista e-posti ost
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=cancelMailActivation&id=$id

Parameetrid:

$api_key - API võti

$id- ostu ID

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

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

VÕIMALIKUD VEAD:

EARLY_CANCEL_DENIED - Esimese 2 minuti jooksul ei saa e-posti tellimust tühistada.

Kontrollige, kas e-kiri on kätte saadud
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=checkMailActivation&id=$id

Parameetrid:

$api_key - API võti

$id- Ostetud e-posti aadressi ID, mis tagastatakse pärast e-posti ostmist

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

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

API partneri tarkvara

Osta partneri tarkvara
https://api.sms-activate.ai/stubs/handler_api.php?action=buyPartnerProduct&productId=$id&api_key=$api_key

Parameetrid:

$api_key - API võti

$id- Tarkvara ID, mida tuleb osta

VASTUS:

Teenuse vastus on JSON-vormingus, näide:

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

VÕIMALIKUD VEAD:

BAD_DATA - Vale ID või ID ei ole number

HALB_TEGEVUS - vigane toiming või edasimüüja pole kinnitatud.

                        <?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.digital 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 }}