SMS-ACTIVATE
Selain
API-protokolla SMS-Activaten käyttöön
API on protokolla ohjelmistosi ja palvelimemme välillä
API:a tarvitaan sms-, otp- ja pva-vastaanottoprosessin automatisointiin omalta osaltasi
API-mme on täysin yhteensopiva kilpailijoiden sivustojen kanssa
Kaikkien pyyntöjen on kohdistuttava osoitteeseen https://api.sms-activate.ai/stubs/handler_api.php
POST- tai GET-pyyntö.
Kaikkien pyyntöjen on sisällettävä API-avain api_key GET-parametrina
Lataa protokollan toteutus PHP:llä Lataa valmis protokollan toteutus PythonillaAktivointi-API
Parametrit:
$api_key - API-avain
$country * - maan numero katso taulukko
$operaattori * matkapuhelinoperaattorien numerot, voit määrittää useita numeroita pilkuilla erotettuina (saatavilla vain:
** saatavilla maalle $country = 0, $country = 1, $country = 2
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{"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}
Viivan edessä on palvelun nimi, viivan jälkeen määritetään, tarvitaanko uudelleenohjausta. 0 – ei, 1 – kyllä.
Parametrit:
$api_key - API-avain
$service * - Palvelu katso taulukko
* valinnainen parametri. Jos sitä ei ole määritetty, näytetään oletusarvoisesti kaikkien palveluiden suosituimmat maat.
$freePrice * - valinnainen parametri. Jos annettu true, määrä ja hinta perustuvat Free Price -hintoihin
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{
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 pyyntö cashback-tilillä:
* palauttaa saldon ottaen huomioon kertyneen cashbackin, jos cashback-tilin asetuksissa on valittuna 'Käytä cashback aktivointeihin'
Parametrit:
$api_key - API-avain
VASTAUS:
ACCESS_BALANCE: 'tilin saldo'
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
ERROR_SQL - SQL-palvelinvirhe
* palauttaa kaikki siirretylle maalle saatavilla olevat operaattorit; jos maata ei ole siirretty, palautetaan kaikki kullekin maalle saatavilla olevat operaattorit
Parametrit:
$api_key - API-avain
$country - maakoodi
VASTAUS:
Palvelun vastaus on JSON-muodossa:
{"status":"success", "countryOperators": {
"Country1Code": ["operator1Name","operator2Name","operator3Name", ...],
"Country2Code": ["operator1Name","operator2Name","operator3Name", ...],
...
}}
Esimerkki:
{"status":"success", "countryOperators": {
"0": ["beeline","megafon","mts", ...],
"1": ["life","mts","kyivstar","utel" ...],
...
}}
* 'countryOperators'-objektin sisällä avaimena on maakoodi
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
ERROR_SQL - SQL-palvelinvirhe
OPERATORS_NOT_FOUND - tietueita ei löytynyt (esim. siirretty olematon maa)
Parametrit:
$api_key - API-avain
VASTAUS:
Palvelun vastaus on JSON-muodossa:
{"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",
}]
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
ERROR_SQL - SQL-palvelinvirhe
NO_ACTIVATIONS - merkintöjä ei löytynyt (ei aktiivisia aktivointeja)
Parametrit:
$api_key - API-avain
$service - tilattava palvelu katso taulukko
$forward * - tarvitaako numeron tilaaminen uudelleenohjauksella
* valinnainen parametri, hyväksyy arvot 0 (ei suoriteta, oletusarvo) tai 1 (suorita)
$maxPrice * - enimmäishinta, jonka olet valmis maksamaan numerosta Free Price -hinnoilla
* valinnainen parametri; jos sitä ei ole määritetty, ostos tehdään normaalihintaan
$phoneException * - venäläisten numeroiden etuliitteiden poissulkeminen. Syötä pilkulla erotettuna. Muoto: maakoodi ja 3–6 numeroa maskista (esim. 7918, 7900111). Oletusarvona on tilissä määritetty arvo.
$operaattori* on numeron matkapuhelinoperaattori. Voit määrittää useita operaattoreita pilkulla erotettuna (käytettävissä vain **)
$aktivointityyppi - aktivointityyppi: 0 - SMS-viestillä (oletus), 1 - numerolla, 2 - äänipuhelulla
$kieli - jäsennyskieli (vaaditaan äänipuheluaktivoinnissa) katso taulukko
$käyttäjäId * - käyttäjätunniste, joka estetään heikkojen aktivointitilastojen vuoksi, mutta jälleenmyyjän omaa tiliä ei vaikuta.
* valinnainen kenttä
** saatavilla maalle $country = 0, $country = 1, $country = 2
$viite - siirrä viitetunniste.
$country - maan numero katso taulukko
$käytäCashbackia* - hyväksyy totuusarvon. Jos parametrin arvo on 'true', numeron ostaminen tehdään käyttämällä cashbackia. Kun cashback-saldosi loppuu, kaikki myöhemmät ostot tehdään pääsaldosta. On TÄRKEÄÄ muistaa, että kaikki myöhemmät ostot käyttävät ensisijaisesti cashbackia ja sen jälkeen pääsaldoa (vaikka parametrina olisi myöhemmin 'false').
* valinnainen parametri, hyväksyy arvon 'true'
Hankkimalla numeron API:n kautta, hyväksyt projektin säännöt projektin säännöt
MAHDOLLISET VIRHEET:
VÄÄRÄ_MAX_HINTA:$min- määritetty enimmäishinta on pienempi kuin sallittu
$min - vähimmäissallittu hinta
HUONO_TOIMINTO - virheellinen toiminto
HUONO_PALVELU - virheellinen palvelun nimi
BAD_KEY - virheellinen API-avain
ERROR_SQL - SQL-palvelinvirhe
ESTETTY:'YYYY-m-d H-i-s' - aika, jonka tilisi on estetty
VÄÄRÄ_POISSULJETTU_PUHELIN - virheelliset poissuljetut etuliitteet
EI_SALDOA_EDISTYS - ei tarpeeksi varoja ostaa puhelun edelleenohjausta
KANAVIEN_RAJA - tili estetty
EI_NUMEROITA - ei numeroita
Jos yrität hankkia tietyn operaattorin numeron, joka ei toimi valitussa maassa tai jossa ei ole valittua palvelua, palautetaan ensimmäisen pyyntöparametreihin sopivan operaattorin numero
menetelmä toimii samalla tavalla kuin menetelmä getNumber, hyväksyy samat parametrit ja alla kuvatut lisäparametrit, mutta palauttaa lisätietoja aktivoinnista
Parametrit:
$tilausId- aktivointitunniste jälleenmyyjän järjestelmässä. Ostettaessa nämä tiedot verrataan aktivointitunnisteeseen ja jälleenmyyjään järjestelmässämme. Näin haluamme saavuttaa idempotenssin (samaa tilausta ei käsitellä uudelleen).
VASTAUS:
Jos pyyntö onnistuu, vastaus on seuraavassa muodossa:
{
"activationId": 635468024,
"phoneNumber": "79584******",
"activationCost": "12.50",
"countryCode": "0",
"canGetAnotherSms": "1",
"activationTime": "2022-06-01 17:30:57",
"activationOperator": "mtt"
}
Jos yrität hankkia tietyn operaattorin numeron, joka ei toimi valitussa maassa tai jossa ei ole valittua palvelua, palautetaan ensimmäisen pyyntöparametreihin sopivan operaattorin numero
MAHDOLLISET VIRHEET:
ORDER_ALREADY_EXISTS- tilaus on jo luotu
Kun vastaanotat tekstiviestin numeroon ja olet ottanut Webhooks-toiminnon käyttöön asetuksissasi, lähetämme tiedot tekstiviestistä määrittämiisi osoitteisiin POST-pyynnöllä.
VASTAUS:
Vastauksen muoto on seuraava:
{
"activationId": 635468024,
"service": "go",
"text": "Your sms text",
"code": "Your sms code",
"country": 0,
"receivedAt": "2022-06-01 17:30:57",
}
Pyyntöä lähettäessämme odotamme skriptiltäsi vastausta HTTP-tilakoodilla 200. Jos skriptisi ei vastaa, lähetämme pyynnön uudelleen 2 tunnin kuluessa, kuitenkin enintään 8 kertaa.
Voit ottaa tämän toiminnon käyttöön kohdassa profiiliasetukset
Parametrit:
$api_key - API-avain
$service - tilattava palvelu katso taulukko
$forward * - tarvitaako numeron tilaaminen uudelleenohjauksella
* valinnainen parametri, välityskoodit erotetaan pilkuilla; välitettävien numeroiden määrän on vastattava parametrissa lähetettyjen palveluiden määrää $service. Sallittua on lähettää vain yksi palvelu uudelleenohjauksella, esimerkiksi "0,1,0,0" on oikein, "0,1,1,0" on väärin. Arvot: 0 (ei suoriteta, oletus), 1 (suorita)
$operaattori * - numeron matkapuhelinoperaattori, voit määrittää useita arvoja pilkulla erotettuna (saatavilla vain **):
$viite - siirrä viitetunniste.
$country - maan numero katso taulukko
Hankkimalla numeron API:n kautta, hyväksyt projektin säännöt projektin säännöt
VASTAUS:
EI_NUMEROITA - ei numeroita
NO_BALANCE - saldo on loppunut
{{'phone':phone,'activation':activation,'service':service},
{'phone':phone,'activation':activation,'service':service}}, missä (phone - operaation ID, activation - puhelinnumero, service - palvelu)
MAHDOLLISET VIRHEET:
HUONO_TOIMINTO - virheellinen toiminto
HUONO_PALVELU - virheellinen palvelun nimi
BAD_KEY - virheellinen API-avain
ERROR_SQL - SQL-palvelinvirhe
ESTETTY:'YYYY-m-d H-i-s' - aika, jonka tilisi on estetty
Parametrit:
$api_key - API-avain
$id - aktivoinnin ID
$forward * - puhelinnumero, johon haluat ohjata
* vaaditaan vain, jos parametrina on annettu getNumber forward=1.
$status - aktivoinnin tila
1 - ilmoita numeron saatavuudesta (tekstiviesti lähetetty numeroon)
3 - pyydä uusi koodi (ilmainen)
6 - lopeta aktivointi *
8 - ilmoita, että numero on jo käytetty, ja peruuta aktivointi
* Jos tila oli 'koodi vastaanotettu', merkitse se onnistuneeksi ja suorita loppuun; jos tila oli 'valmistelu', poista ja merkitse virheeksi; jos tila oli 'odottaa uudelleenyritystä', siirrä aktivointi odottavien tekstiviestien jonoon
** Aktivoinnin tilaa ei voi muuttaa, jos vahvistustavaksi on valittu puhelinvahvistus ja numero on jo saapunut
API:n käytön yksinkertainen kronologinen logiikka:
Hanki numero getNumber-menetelmällä, jonka jälkeen seuraavat toiminnot ovat käytettävissä:
8 - peruuta aktivointi (jos numero ei sovi sinulle)
1 - ilmoita, että tekstiviesti on lähetetty (valinnainen)
Aktivoinnille, jonka tila on 1:
8 - peruuta aktivointi
Välittömästi koodin vastaanottamisen jälkeen:
3 - pyydä uusi tekstiviesti
6 - vahvista tekstiviestikoodi ja lopeta aktivointi
Aktivoinnille, jonka tila on 3:
6 - vahvista tekstiviestikoodi ja lopeta aktivointi
VASTAUS:
ACCESS_READY - numeron valmius vahvistettu
ACCESS_RETRY_GET - odotetaan uutta SMS-viestiä
ACCESS_ACTIVATION - palvelu on aktivoitu onnistuneesti
ACCESS_CANCEL - aktivointi peruutettu
MAHDOLLISET VIRHEET:
EARLY_CANCEL_DENIED - numeron peruuttaminen ei ole sallittua ensimmäisen 2 minuutin aikana
ERROR_SQL - SQL-palvelinvirhe
NO_ACTIVATION - aktivointitunnistetta ei ole olemassa
HUONO_PALVELU - virheellinen palvelun nimi
BAD_STATUS - virheellinen tila
BAD_KEY - virheellinen API-avain
HUONO_TOIMINTO - virheellinen toiminto
WRONG_ACTIVATION_ID - virheellinen tunnus tai tunnus ei ole numero.
Parametrit:
$api_key - API-avain
$id - aktivoinnin ID
VASTAUS:
STATUS_WAIT_CODE - odotetaan SMS-viestiä
STATUS_WAIT_RETRY: 'menneisyys, täsmäämätön koodi' - odotetaan koodin tarkennusta
STATUS_WAIT_RESEND - odotetaan SMS-viestin uudelleenlähetystä *
* ohjelmiston on painettava SMS-viestin uudelleenlähetys ja muutettava tilaksi 6
STATUS_CANCEL - aktivointi peruutettu
STATUS_OK: 'aktivointikoodi' - koodi vastaanotettu
MAHDOLLISET VIRHEET:
NO_ACTIVATION - aktivointitunnistetta ei ole olemassa
ERROR_SQL - SQL-palvelinvirhe
BAD_KEY - virheellinen API-avain
HUONO_TOIMINTO - virheellinen toiminto
Parametrit:
$api_key - API-avain
$id - aktivoinnin ID
VASTAUS:
Vastauksen muoto on seuraava:
{
"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 - aktivointi peruutettu
MAHDOLLISET VIRHEET:
NO_ACTIVATION - aktivointitunnistetta ei ole olemassa
ERROR_SQL - SQL-palvelinvirhe
BAD_KEY - virheellinen API-avain
HUONO_TOIMINTO - virheellinen toiminto
Parametrit:
$api_key - API-avain
$start - aikaleima Unix Timestamp -muodossa (valinnainen) - mistä päivästä alkaen aktivoinnit huomioidaan
$end - aikaleima Unix Timestamp -muodossa (valinnainen) - mihin päivään asti aktivoinnit huomioidaan
$offset - vastauksessa palautettavan ensimmäisen alkion siirtymä. Oletusarvo on 0
$limit - palautettavien tietueiden enimmäismäärä. Enimmäismäärä on 100. Oletusarvo on 50.
VASTAUS:
Vastauksen muoto on seuraava:
[{
"id": 635468024,
"date": "2022-11-12 15:58:39",
"phone": "79918529716",
"sms": "sms":"["Your sms code"]",
"cost": 100 //Если активация не завершена, то cost = 0,
"status": "4",
}]
MAHDOLLISET VIRHEET:
ERROR_SQL - SQL-palvelinvirhe
BAD_KEY - virheellinen API-avain
HUONO_TOIMINTO - virheellinen toiminto
Parametrit:
$api_key - API-avain
$service - palvelun nimi
VASTAUS:
Vastauksen muoto on seuraava:
[{
"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)
}]
MAHDOLLISET VIRHEET:
ERROR_SQL - SQL-palvelinvirhe
BAD_KEY - virheellinen API-avain
WRONG_SERVICE - virheellinen palvelu
HUONO_TOIMINTO - virheellinen toiminto
Parametrit:
$api_key - API-avain
$id - aktivoinnin ID
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{"status":"2","phone":false}
MAHDOLLISET TILAT:
2 - uusi aktivointi
3 - onnistuneesti päättynyt
4 - peruutettu
5 - palautettu
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
VIRHEELLINEN_AKTIIVITUNNUS - Virheellinen aktivointitunnus
Parametrit:
$api_key - API-avain
$servicePalvelun lyhyt nimi (valinnainen, oletuksena kaikki palvelut) katso taulukko
$countryMaakoodin nimi (valinnainen, oletuksena kaikki maat) katso taulukko
VASTAUS:
JSON - objekti muodossa
{"Maa":{"Palvelu":{"hinta":Hinta,"määrä":Määrä}}}
Parametrit:
$api_key - API-avain
$servicePalvelun lyhyt nimi (valinnainen, oletuksena kaikki palvelut) katso taulukko
VASTAUS:
JSON - objekti muodossa
{"Palvelu":{"Maa":{"määrä":Määrä,"hinta":"Hinta"}}}
Parametrit:
$api_key - API-avain
VASTAUS:
JSON - objekti muodossa {{'Страна':{'id':0,'rus':"Россия","eng:"Russia","chn":"俄罗斯","visible":1,"retry":1,"rent":1,"multiService":1}},
missä (
id : maan tunnus;
rus : maan nimi venäjäksi;
eng : maan nimi englanniksi;
chn : maan nimi kiinaksi;
visible : 0 - maata ei näytetä sivustolla, 1 - näytetään;
retry : 0 - uudelleenlähetettyä SMS-viestiä EI ole saatavilla, 1 - saatavilla;
rent : 0 - maata ei voi vuokrata, 1 - vuokrattavissa;
multiService : 0 - maa EI ole saatavilla monipalveluun, 1 - saatavilla.)
Parametrit:
$api_key- API-avain
$country *- Maan tunnus. Jos olet antanut maan, palautamme palvelut, joilla on hinta valitulle maalle
$lang *- kieli, jota käytetään `name`-kentän tarjoamiseen. Mahdolliset arvot: 'ru', 'en', 'es', 'cn'. Oletusarvo on 'en'
* valinnainen parametri
VASTAUS:
JSON - objekti muodossa { "status": "success", "services": [ { "code": "aoo", "name": "Pegasus Airlines" } ] }
Kun olet vastaanottanut ensimmäisen tekstiviestin uudelleenohjatuille numeroille, voit ostaa muita siihen liittyviä palveluita, kuten Yula, Yandex, Avito tai muita.
Lisäpalvelun hinta on vain 5p
Parametrit:
$api_key - API-avain
$service - katso palvelun lyhyt nimi taulukosta katso taulukko
$id - Ylemmän tason aktivointitunnus
VASTAUS:
LISÄ:$id:$puhelinnumero - uusi aktivointi luotiin onnistuneesti. ID on lisäaktivoinnin tunnus, puhelinnumero on puhelinnumero
MAHDOLLISET VIRHEET:
VIRHEELLINEN_LISÄPALVELU - Virheellinen lisäpalvelu (vain edelleenohjauspalvelut sallittuja)
WRONG_ACTIVATION_ID - Virheellinen ylemmän tason aktivointitunnus
VIRHEELLINEN_TURVALLISUUS - tapahtui virhe yritettäessä lähettää aktivointitunnusta ilman uudelleenohjausta tai valmiiksi/inaktiivista aktivointia
TOISTA_LISÄPALVELU - virhe tapahtuu, kun yritetään tilata jo ostettu palvelu uudelleen EI_SALDOA – Varat eivät riitä
ERROR_SQL- tietokantavirhe, ota yhteyttä asiakaspalveluun
Jos olet suorittanut onnistuneen aktivoinnin numerolle, voit tehdä sen uudelleen.
Lisäaktivoinnin hinta määräytyy maan ja palvelun mukaan. Tarkan hinnan saat osoitteesta .
Parametrit:
$api_key - API-avain
$aktivointiTunnus - Ylemmän tason aktivointitunnus
VASTAUS:
ACCESS_NUMBER:$id:$puhelinnumero - uusi aktivointi luotiin onnistuneesti. Missä $id on lisäaktivoinnin tunnus, $phone on puhelinnumero
MAHDOLLISET VIRHEET:
UUDELLEENAKTIVOINTI_EI_SAATAVILLA- numero ei ole käytettävissä lisäaktivointiin
WRONG_ACTIVATION_ID - Virheellinen ylemmän tason aktivointitunnus
ERROR_SQL- tietokantavirhe, ota yhteyttä asiakaspalveluun
UUSI_AKTIVOINTI_MAHDOTON- lisäaktivointia ei voi suorittaa
NO_BALANCE - tilillä ei ole varoja
Voit tarkistaa numeron saatavuuden lisäaktivointiin ja saada sen hinnan
Parametrit:
$api_key - API-avain
$aktivointiTunnus - Ylemmän tason aktivointitunnus
VASTAUS:
JSON - objekti muodossa {'status': 'success', 'cost':200,"service":"tw","phone":777777777,"country":14},
MAHDOLLISET VIRHEET:
UUDELLEENAKTIVOINTI_EI_SAATAVILLA- numero ei ole käytettävissä lisäaktivointiin
WRONG_ACTIVATION_ID - Virheellinen ylemmän tason aktivointitunnus
SIM_OFFLINE - SIM-kortti offline-tilassa
VASTAUS:
Vastauksen muoto on seuraava:
{
"result": "OK"
}
STATUS_CANCEL - aktivointi peruutettu
EI_PUHETTA- puhelua ei vastaanotettu
PARSE_COUNT_EXCEED- jäsentelyyritysten raja (maksimi 4)
MAHDOLLISET VIRHEET:
WRONG_ACTIVATION_ID - virheellinen ID, aktivointia ei ole olemassa
ERROR_SQL - SQL-palvelinvirhe
BAD_KEY - virheellinen API-avain
HUONO_TOIMINTO - virheellinen toiminto
Vuokraus-API
Parametrit:
$api_key - API-avain
$time* - vuokra-aika (oletusarvo: 4 tuntia)
$operaattori* - numeron matkapuhelinoperaattori, voit määrittää useita pilkulla erotettuna (oletusarvo: Mikä tahansa)
$country* - maa (oletusarvo: Venäjä)
$incomingCall * - jos siirretty "true"hanki numero, joka tukee puhelun vastaanottamista
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{ "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 } } }
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
OUT_OF_STOCK - kyseisen maan numerot eivät ole saatavilla
Parametrit:
$api_key - API-avain
$service - palvelu, jota varten tarvitset numeron
$time* - vuokra-aika tunteina (oletusarvo: 4 tuntia). Seuraavat saatavilla olevat aikavälit ovat 12 tuntia ja 24 tuntia. Kun pyydät vuokrausta päiväksi tai pidemmäksi ajaksi, on annettava: 24, 48, 72 jne.
$operaattori* - numeron matkapuhelinoperaattori, voit määrittää useita pilkulla erotettuna (oletusarvo: Mikä tahansa)
$country* - maa (oletusarvo: Venäjä)
$url * - linkki webhookiin (ei oteta huomioon oletusarvoisesti)
$incomingCall * - jos siirretty "true"hanki numero, joka tukee puhelun vastaanottamista
* valinnainen parametri. Jos sitä ei määritetä, käytetään oletusparametria.
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{ "status": "success", "phone": { "id": 1049, "endDate": "2020-01-31T12:01:52", "number": "79959707564" } }
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
Vastaus JSON-muodossa:
{ "status": "error", "message": "*possible_answer*" }
Mahdolliset vastaukset kentässä "message":
HUONO_PALVELU - palvelua ei ole määritetty tai nimi on virheellinen
NO_BALANCE - tilillä ei ole varoja
EI_NUMEROITA - ei numeroita
ACCOUNT_INACTIVE - ei numeroita
SERVER_ERROR - palvelinvirhe
KANAVIEN_RAJA - tili estetty
Parametrit:
$api_key - API-avain
$id - Vuokraus-ID, joka saatiin vastauksessa numeroa tilattaessa
$page* - sivunumero, josta valinta alkaa (sivujen numerointi alkaa nollasta, uusimmista vanhimpiin; oletusarvo on 0)
$size* - sivun koko (oletusarvo 10)
* valinnainen parametri. Jos sitä ei määritetä, käytetään oletusparametria.
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{ "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" } } }
* onnistuu vain, jos SMS on olemassa (kenttä 'quantity' > 0).
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
Vastaus JSON-muodossa:
{ "status": "error", "message": "*possible_answer*" } Mahdolliset vastaukset kentässä "message": NO_ID_RENT - vuokraus-ID:tä ei ole määritetty INVALID_PHONE - numeroa ei ole vuokrannut sinä (virheellinen vuokraustunniste) STATUS_FINISH - vuokraus maksettu ja suoritettu loppuun STATUS_CANCEL - vuokraus peruutettu ja rahat palautettu STATUS_WAIT_CODE - odotetaan ensimmäistä SMS-viestiä STATUS_REVOKE - numero on estetty, varasi on palautettu
Parametrit:
$api_key - API-avain
$id - Vuokraus-ID, joka saatiin vastauksessa numeroa tilattaessa
$status - tilan muutoskoodi (numero)
Tila voi olla:
VASTAUS:
Palvelun vastaus on JSON-muodossa:
{ "status": "success" }
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
Vastaus JSON-muodossa:
{ "status": "error", "message": "*possible_answer*" }
Mahdolliset vastaukset kentässä "message":
NO_ID_RENT - vuokraus-ID:tä ei ole määritetty
INCORECT_STATUS - puuttuva tai virheellisesti määritetty tila
CANT_CANCEL - vuokrausta ei voi perua (yli 20 min kulunut)
INVALID_PHONE - numeroa ei ole vuokrannut sinä (virheellinen vuokraustunniste)
ALREADY_FINISH - vuokraus on jo saatu päätökseen
ALREADY_CANCEL - vuokraus on jo peruutettu
SERVER_ERROR - palvelinvirhe
👉Huomio! Tämä menetelmä näyttää vain viimeiset 10 numeroa. Jos tarvitset lisää numeroita, käytä getRentStatus -menetelmää tilojen tarkistamiseen.
Parametrit:
$api_key - API-avain
VASTAUS:
Palvelun vastaus on JSON-muodossa:
{ "status": "success", "values": { "0": { "id": "12345", "phone": "79181234567" }, "1": { "id": "12345", "phone": "79181234568" } } }
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
HUONO_TOIMINTO - virheellinen toiminto
Vastaus JSON-muodossa:
{ "status": "error", "message": "*possible_answer*" }
Mahdolliset vastaukset kentässä "message":
EI_NUMEROITA - ei vuokrattuja numeroita
SERVER_ERROR - palvelinvirhe
Parametrit:
$api_key - API-avain
$id - vuokrauksen id
$rent_time- vuokrausaika (oletuksena: 4 tuntia)
VASTAUS:
Palvelun vastaus on JSON-muodossa:
{ "status": "success", "phone": { "id": 1049, "endDate": "2020-01-31T12:01:52", "number": "79959707564"} }
Kun päättynyt vuokraus jatketaan, se tilataan uudelleen ja annetaan uusi tunniste
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
HUONO_TOIMINTO - virheellinen toiminto
SERVER_ERROR - palvelinvirhe
Vastaus JSON-muodossa:
{ "status": "error", "message": "*possible_answer*", "info": "*details*" }
Mahdolliset vastaukset kentässä "message":
NO_ID_RENT - vuokraustunnistetta ei ole
INVALID_TIME - virheellinen aika. Saatavilla olevat tunnit välillä 4–1344
MAX_HOURS_EXCEED - Enimmäisaika ylitetty
max - enimmäisaika saatavilla
INVALID_PHONE - virheellinen vuokraustunniste
RENT_DIE - vuokra-aikaa ei voi pidentää, koska numero on vanhentunut
NO_BALANCE - varat eivät riitä
KANAVIEN_RAJA - tili estetty
* tämä menetelmä on saatavilla vain MTT-operaattorin vuokrapalveluissa.
Parametrit:
$api_key - API-avain
$id - vuokrauksen id
$rent_time - vuokra-aika
VASTAUS:
Palvelun vastaus on JSON-muodossa:
{ "status": "success", "price": 6.33 }
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
HUONO_TOIMINTO - virheellinen toiminto
SERVER_ERROR - palvelinvirhe
Vastaus JSON-muodossa:
{ "status": "error", "message": "*possible_answer*" }
Mahdolliset vastaukset kentässä "message":
NO_ID_RENT - vuokraustunnistetta ei ole
INVALID_PHONE - virheellinen vuokraustunniste
INVALID_TIME - virheellinen aika-asetus
RENT_DIE - vuokra-aikaa ei voi pidentää, koska numero on vanhentunut
MAX_HOURS_EXCEED - Enimmäisaika ylitetty
max - enimmäisaika saatavilla
KANAVIEN_RAJA - tili estetty
API JAVA
Lisää kirjasto Maveniin
<artifactId>SMSActivateApi</artifactId>
<version>1.0</version>
</riippuvuus>
Voit tarkastella rekisteröintiesimerkkiä linkistä MavenRepositoryyn
Tuo pääluokka SMS-Activate API:n kanssa toimimista varten.
Kirjaston käyttämiseksi tarvitset API-avaimen, jonka voit hankkia tältä sivulta ja alla olevasta linkistä.
SMS-Activate API-avainHanki tilisi nykyinen saldo käyttämällä metodia getBalance... Jos haluat saldon lisäksi nähdä cashback-määrän, kutsu metodia getBalanceAndCashBack.
Menetelmä getBalanceAndCashBack palauttaa luokkaolionSMSActivateGetBalanceAndCashBack.
Parametrit:
EI MITÄÄN
PALUUTYYPPI:
BigDecimal
Parametrit:
EI MITÄÄN
PALUUTYYPPI:
Parametrit:
countryId(Integer) - maatunniste.
service(String) - palvelun lyhyt nimi.
forward*(boolean) - pyydetäänkö numeroa soitonsiirrolla.
operaattoriJoukko*(Joukko) - operaattorijoukko.
puhelinPoikkeus*(Joukko) - ei sisällä etuliitteitä vain Venäjälle, numeroiden joukko 3–6 (7918,7900111).
* valinnainen kenttä. Jos mitään ei ole määritetty, oletusmäärä annetaan profiilin asetusten mukaisesti.
PALUUTYYPPI:
Parametrit:
countryId(Integer) - maatunniste.
operaattoriJoukko*(Joukko) - palvelulle saatavilla olevien operaattorien joukko
PALUUTYYPPI:
Parametrit:
id(Kokonaisluku) - aktivoinnin tunniste
service(String) - palvelun lyhyt nimi.
Aktivointitunnisteen sijaan voit välittää vastaanotetun luokkaobjektin SMSActivateActivation metodin käytön jälkeen getNumber tai yhden aktivoinneista käytön jälkeen getMultiServiceNumber.
PALUUTYYPPI:
Parametrit:
countryId(Integer) - maatunniste.
palveluKartta(Joukko) - niiden palvelujen joukko, joille aktivointi on ostettu
multiForwardList(Lista) - lista palveluista, joissa puheluiden edelleenohjaus on saatavilla
operaattoriJoukko(Joukko) - operaattorijoukko.
PALUUTYYPPI:
Parametrit:
EI MITÄÄN
PALUUTYYPPI:
Parametrit:
countryId(Integer) - maatunniste.
service(String) - palvelun lyhyt nimi.
PALUUTYYPPI:
Parametrit:
countryId(Integer) - maatunniste.
PALUUTYYPPI:
Parametrit:
aktivointiTunniste(Kokonaisluku) - aktivoinnin tunniste
Aktivointitunnisteen sijaan voit välittää vastaanotetun luokkaobjektin SMSActivateActivation metodin käytön jälkeen getNumber tai yhden aktivoinneista käytön jälkeen getMultiServiceNumber.
PALUUTYYPPI:
Parametrit:
id(Kokonaisluku) - aktivoinnin tunniste
tila(SMSActivateClientStatus) - aktivoinnille asetettava tila
Aktivointitunnisteen sijaan voit välittää vastaanotetun luokkaobjektin SMSActivateActivation metodin käytön jälkeen getNumber tai yhden aktivoinneista käytön jälkeen getMultiServiceNumber.
PALUUTYYPPI:
Parametrit:
EI MITÄÄN
PALUUTYYPPI:
Parametrit:
aktivointiTunniste(Kokonaisluku) - aktivoinnin tunniste
Aktivointitunnisteen sijaan voit välittää vastaanotetun luokkaobjektin SMSActivateActivation metodin käytön jälkeen getNumber tai yhden aktivoinneista käytön jälkeen getMultiServiceNumber.
PALUUTYYPPI:
Algoritmi koko SMS-viestin tekstin vastaanottamiseksi aktivoinnin yhteydessä
Hanki numero getNumber-menetelmällä, jonka jälkeen seuraavat toiminnot ovat käytettävissä:
CANCEL - 8 - Peruuta aktivointi (jos numero ei sovi sinulle)
MESSAGE_WAS_SENT - Ilmoittaa, että SMS on lähetetty (pakollinen koko tekstiviestin vastaanottamiseksi)
Kun MESSAGE_WAS_SENT-tila on asetettu pakollisesti, aseta muuttuja vastaanottamaan SMS waitSMS-menetelmällä käyttäen aktivointiparametreja ja odotusaikaa.
Kun olet vastaanottanut SMS-viestin, voit hakea sen getFullSMS-menetelmällä ja näyttää koko tekstin getText()-menetelmällä.
Tämän jälkeen voit asettaa aktivoinnit seuraaviin tiloihin:
Aktivoidaksesi tilassa MESSAGE_WAS_SENT:
CANCEL - Peruuta aktivointi
Välittömästi koodin vastaanottamisen jälkeen:
REQUEST_ONE_MORE_CODE - Pyydä toinen SMS
FINISH - Vahvista SMS-koodi ja viimeistele aktivointi
Aktivoidaksesi tilassa REQUEST_ONE_MORE_CODE:
FINISH - Vahvista SMS-koodi ja viimeistele aktivointi
Parametrit:
countryId(Integer) - maatunniste.
service(String) - palvelun lyhyt nimi.
hours(Integer)* - vuokra-aika
operator(String)* - matkapuhelinoperaattorin nimi
urlWebhook(String)* - webhook-linkki (ei oteta huomioon oletuksena)
Mikä on webHook?* valinnainen parametri. Jos sitä ei määritetä, käytetään oletusarvoa
PALUUTYYPPI:
Parametrit:
countryId(Integer) - maatunniste.
operaattoriJoukko(Joukko) - joukko matkapuhelinoperaattoreita
hours(Integer)* - vuokra-aika
* valinnainen parametri. Jos sitä ei määritetä, käytetään oletusarvoa
PALUUTYYPPI:
Parametrit:
rentId(Integer) - vuokratun numeron tunniste
rentId:n sijaan voit välittää saadun luokkaobjektin SMSActivateRentActivation metodin käytön jälkeen getRentNumber
PALUUTYYPPI:
Sähköpostin API
API-tilojen kuvaus
3 - Odottaa
4 - Peruutettu
5 - Onnistui
KUVAUS:
REST API -periaatteiden tiukempi noudattaminen ja gmail.com-sähköpostilaatikoiden määrän lisääminen Telegram-tilejen rekisteröintiä varten.
Parametrit:
$api_key - API-avain
$site- sivusto, jolle tarvitset sähköpostin
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{
"status":"OK",
"response":{
"zones":[
{
"name":"info",
"cost":2.5
},
...
],
"popular":[
{
"name":"mail.ru",
"cost":6,
"count":159008
},
...
]
}
}
MAHDOLLISET VIRHEET:
BAD_SITE- Sivustoa ei ole määritetty
BAD_KEY - virheellinen API-avain
HUONO_TOIMINTO - virheellinen toiminto
Parametrit:
$api_key - API-avain
$site - sivusto, jolle tarvitset sähköpostin
$mail_type - sähköpostityyppi: suosittuja domain-alueita tai vyöhykkeitä (1 - vyöhykkeet, 2 - suositut)
$mail_domain - valittu vyöhyke tai verkkotunnus
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{
"status":"OK",
"response":{"email":"[email protected]","id":241}
}
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
HUONO_TOIMINTO - virheellinen toiminto
MAIL_TYPE_ERROR - määritetylle sivustolle ei ole tällaista verkkotunnusta
KANAVIEN_RAJA - tili estetty
Parametrit:
$api_key - API-avain
$id- Sähköpostin tunnus, jonka uudelleenaktivointi vaaditaan
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{
"status": "OK",
"response": {
"email": "[email protected]",
"id": 360
}
}
MAHDOLLISET VIRHEET:
BAD_KEY - virheellinen API-avain
HUONO_TOIMINTO - virheellinen toiminto
BLOCKED_SITE - estetty sivusto
BAD_BALANCE - varat eivät riitä
ACTIVATION_NOT_FOUND - aktivointia ei löytynyt
KANAVIEN_RAJA - tili estetty
Parametrit:
$api_key - API-avain
$page- sivunumero
$per_page- ostosten määrä per sivu
$search- hakukenttä
$sort- lajittelusuunta (desc, asc)
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{
"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
}
}
Parametrit:
$api_key - API-avain
$id- ostoksen tunnus
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{
"status":"OK",
"response":true
}
MAHDOLLISET VIRHEET:
EARLY_CANCEL_DENIED - Et voi peruuttaa sähköpostia ensimmäisen 2 minuutin aikana.
Parametrit:
$api_key - API-avain
$id- Ostetun sähköpostin tunnus, palautetaan sähköpostin oston jälkeen
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{
"status":"OK",
"response":{
"value":"Содержания письма"
}
}
API-kumppaniohjelmisto
Parametrit:
$api_key - API-avain
$id- Ohjelmiston tunnus, joka on ostettava
VASTAUS:
Palvelun vastaus on JSON-muodossa, esimerkki:
{
"status": "success",
"key": "F5qrzFoY6afj3zrEq7SeMplbx",
"manual": "Software download link:"
}
MAHDOLLISET VIRHEET:
BAD_DATA - Virheellinen tunnus tai tunnus ei ole numero
HUONO_TOIMINTO - virheellinen toiminto tai jälleenmyyjää ei ole vahvistettu.
<?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.fit 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