Dimar FZC LLC
Flamingo Villas A-32-01-05-03 25314 Falme za Kiarabu, Ajman
+971585072431, /assets/img/icons/logo/logo.svg, [barua pepe imelindwa]

Itifaki ya API ya kufanya kazi na SMS-Activate

API ni itifaki kati ya programu yako na seva yetu

API inahitajika kwa ajili ya automatization ya mchakato wa kupokea sms, otp, na pva upande wako

API yetu inalingana kabisa na tovuti za washindani

Maombi yote yanapaswa kwenda https://api.sms-activate.ai/stubs/handler_api.php

Ombi la POST au GET.

Maombi yote yanapaswa kujumuisha ufunguo wa API katika muundo wa kipengee cha api_key cha GET

Pakua utekelezaji wa itifaki katika php Pakua utekelezaji tayari wa itifaki katika Python

API ya Uanzishaji

Omba idadi inayopatikana ya nambari za virtual
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getNumbersStatus&country=$country&operator=$operator

Vigezo:

$api_key - Kitufe cha API

$country * - nambari ya nchi tazama jedwali

$operator * nambari za watoa huduma wa simu za mkononi, unaweza kubainisha nambari kadhaa zikitenganishwa na koma (inapatikana tu kwa:

Urusi
megafon, mts, beeline, tele2, rostelecom, yoyote
Ukraina
kyivstar, life, utel, mts, vodafone
Kazakhstan
tele2, beeline, activ, altel

** inapatikana kwa $country = 0, $country = 1, $country = 2

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

{"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}
Ambapo kabla ya kistari ni jina la huduma, baada ya uteuzi ikiwa ni lazima kujumuisha uelekezaji upya. 0 - hapana. 1 - ndiyo.

Orodha kamili ya huduma

Omba nchi zinazoongoza kulingana na huduma BeiYaBure
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getTopCountriesByService&service=$service&freePrice=$freePrice

Vigezo:

$api_key - Kitufe cha API

$service * - Huduma tazama jedwali

* kipengele cha hiari. Ikiwa hakijatajwa, nchi zinazoongoza kwa huduma zote zitaonyeshwa chaguo-msingi.

$freePrice * - kipengele cha hiari. Ikiwa kimetolewa true, idadi na bei zitatoledwa kulingana na Bei ya Bure

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

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

Ombi la salio lenye akaunti ya cashback:

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

* hurudisha salio ukizingatia cashback iliyokusanywa, ikiwa kisanduku cha kuchagua katika mipangilio ya akaunti ya cashback 'Tumia cashback kwa uanzishaji' kimewekwa alama

Vigezo:

$api_key - Kitufe cha API

JIBU:

ACCESS_BALANCE: 'salio la akaunti'

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

ERROR_SQL - hitilafu ya sql-server

Omba watoa huduma waliopo
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getOperators&country=$country

* hurudisha watoa huduma wote waliopo kwa nchi iliyohamishwa, ikiwa nchi haijahamishwa - itarudisha watoa huduma wote waliopo kwa kila nchi

Vigezo:

$api_key - Kitufe cha API

$country - msimbo wa nchi

JIBU:

Jibu la huduma litakuwa katika muundo wa json:

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

Mfano:

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

* ndani ya 'countryOperators' - ufunguo utakuwa msimbo wa nchi

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

ERROR_SQL - hitilafu ya sql-server

OPERATORS_NOT_FOUND - hakuna rekodi zilizopatikana (k.m. nchi isiyoipo imehamishwa)

Omba uanzishaji unaofanya kazi
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getActiveActivations

Vigezo:

$api_key - Kitufe cha API

JIBU:

Jibu la huduma litakuwa katika muundo wa json:

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

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

ERROR_SQL - hitilafu ya sql-server

NO_ACTIVATIONS - hakuna ingizo zilizopatikana (hakuna uanzishaji unaofanya kazi)

Omba nambari BeiYaBure
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

Vigezo:

$api_key - Kitufe cha API

$service - huduma ya kuagiza tazama jedwali

$forward * - je, ni lazima kuomba nambari yenye uelekezaji upya

* kipengele cha hiari, kinakubali 0 (usitekeleze, kimewekwa chaguo-msingi), 1 (tekeleza)

$maxPrice * - bei ya juu ambayo uko tayari kununua nambari kwa Bei ya Bure

* kipengele cha hiari, ikiwa hakijatajwa, ununuzi utafanyika kwa bei ya kawaida

$phoneException * - isipokuwa viambishi awali vya nambari za Urusi. Ingiza kwa kutumia koma. Muundo wa rekodi: msimbo wa nchi na tarakimu 3 hadi 6 za maski (k.m. 7918, 7900111). Thamani chaguo-msingi ni thamani iliyotajwa katika akaunti.

$operator* ni mtandao wa simu za mkononi wa nambari, unaweza kubainisha kadhaa zao kwa kutumia koma (inapatikana tu kwa **)

$activationType - aina ya uanzishaji: 0 - na SMS (chaguo-msingi), 1 - na nambari, 2 - na sauti

$language - lugha ya uchambuzi (inahitajika kwa uanzishaji wenye sauti) tazama jedwali

$userId * - Kitambulisho cha mtumiaji cha kuzuia kwa takwimu duni za uanzishaji, lakini akaunti yake mwenyewe ya muuzaji tena haiathiriwi.

Urusi
megafon, mts, beeline, tele2, rostelecom, yoyote
Ukraina
kyivstar, life, utel, mts, vodafone
Kazakhstan
tele2, beeline, activ, altel

* sehemu hiari

** inapatikana kwa $country = 0, $country = 1, $country = 2

$ref - hamisha kitambulisho cha marejeleo.

$country - nambari ya nchi tazama jedwali

$useCashBack* - huchukua thamani ya kimantiki, ikiwa kipengele ni 'true', ununuzi wa nambari utafanywa kwa kutumia cashback. Baada ya pesa kuisha kwenye salio la cashback, manunuzi yote yatafanywa kwa kutumia salio kuu. Ni MUHIMU kukumbuka kwamba manunuzi yote yataanza kwa kutumia cashback, na baadaye salio kuu litatumika (hata ukipitisha kipengele 'false' baadaye).

* kipengele hiari, kinakubali 'true'

Kwa kupata nambari kupitia API, unakubaliana na kanuni za mradi kanuni za mradi

MAKOSA YANAYOWEZEKANA:

WRONG_MAX_PRICE:$min- bei ya juu iliyobainishwa ni chini ya ile inayoruhusiwa

$min - kiwango cha chini cha bei kinachoruhusiwa

BAD_ACTION - kitendo kisicho sahihi

BAD_SERVICE - jina la huduma lisilo sahihi

BAD_KEY - ufunguo wa API usio sahihi

ERROR_SQL - hitilafu ya sql-server

BANNED:'YYYY-m-d H-i-s' - muda ambao akaunti imezuiwa

WRONG_EXCEPTION_PHONE - viambishi vya uondoaji visivyo sahihi

NO_BALANCE_FORWARD - hazitoshi fedha kununua uelekezaji wa simu

CHANNELS_LIMIT - akaunti imezuiwa

NO_NUMBERS - hakuna nambari

Ikiwa utajaribu kupata nambari ya mtandao maalum ambao haufanyi kazi katika nchi uliyochagua au ambayo haina huduma uliyochagua, nambari ya mtandao wa kwanza unaolingana na vigezo vya ombi itarudishwa

Ombi la Nambari V2 BeiYaBure
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

njia hii inafanya kazi sawa na njia getNumber, inakubali vigezo vilevile na vingine vyongezeo vilivyoelezwa hapa chini, lakini hurudisha taarifa za ziada za uanzishaji

Vigezo:

$orderId- kitambulisho cha uanzishaji kutoka kwenye mfumo wa muuzaji tena. Wakati wa kununua, data hii inalinganishwa na kitambulisho cha uanzishaji na muuzaji tena katika mfumo wetu. Kwa hivyo, tunataka kufanikisha idempotence (agizo lilelile halitachakatwa tena).

JIBU:

Ikiwa ombi litafanikiwa, majibu yatakuwa katika muundo ufuatao:

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

Ikiwa utajaribu kupata nambari ya mtandao maalum ambao haufanyi kazi katika nchi uliyochagua au ambayo haina huduma uliyochagua, nambari ya mtandao wa kwanza unaolingana na vigezo vya ombi itarudishwa

MAKOSA YANAYOWEZEKANA:

ORDER_ALREADY_EXISTS- agizo tayari limetengenezwa

Webhooks

Unapopokea SMS kwenye nambari, ikiwa umewezesha kipengele cha Webhooks katika mipangilio yako, tutatuma taarifa kuhusu SMS hiyo kwa anwani ulizobainisha kwa kutumia ombi la POST

JIBU:

Muundo wa majibu utakuwa kama ifuatavyo:

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

Wakati wa kutuma ombi, tutangojea majibu kutoka kwa skripti yako yenye hali ya HTTP 200. Ikiwa skripti yako haitatoa majibu, tutatuma ombi tena ndani ya saa 2, lakini si zaidi ya mara 8.

Unaweza kuwezesha kipengele hiki katika mipangilio ya wasifu

Kuagiza nambari ya simu ya virtual kwa huduma kadhaa
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

Vigezo:

$api_key - Kitufe cha API

$service - huduma ya kuagiza tazama jedwali

$forward * - je, ni lazima kuomba nambari yenye uelekezaji upya

* parameta ya hiari, herufi za uelekezaji zimetenganishwa na koma, idadi ya tarakimu za uelekezaji lazima ilingane na idadi ya huduma zilizotumwa katika parameta $service. Inaruhusiwa kutuma huduma 1 tu yenye uelekezaji, kwa mfano "0,1,0,0" - sahihi, "0,1,1,0" - si sahihi. Inachukua 0 (usitekeleze, chaguo-msingi), 1 (tekeleza)

$operator * - mtandao wa simu ya mkononi wa nambari, unaweza kubainisha nambari kadhaa zikitenganishwa na koma (inapatikana kwa ** pekee):

Urusi
megafon, mts, beeline, tele2, rostelecom, yoyote
Ukraina
kyivstar, life, utel, mts, vodafone
Kazakhstan
tele2, beeline, activ, altel

$ref - hamisha kitambulisho cha marejeleo.

$country - nambari ya nchi tazama jedwali

Kwa kupata nambari kupitia API, unakubaliana na kanuni za mradi kanuni za mradi

JIBU:

NO_NUMBERS - hakuna nambari

NO_BALANCE - salio limeisha

{{'phone':phone,'activation':activation,'service':service},
{'phone':phone,'activation':activation,'service':service}}
, ambapo (phone - kitambulisho cha shughuli, activation - Nambari ya simu, service - Huduma)

MAKOSA YANAYOWEZEKANA:

BAD_ACTION - kitendo kisicho sahihi

BAD_SERVICE - jina la huduma lisilo sahihi

BAD_KEY - ufunguo wa API usio sahihi

ERROR_SQL - hitilafu ya sql-server

BANNED:'YYYY-m-d H-i-s' - muda ambao akaunti imezuiwa

Mabadiliko ya hali ya uanzishaji
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id&forward=$forward

Vigezo:

$api_key - Kitufe cha API

$id - Kitambulisho cha Uanzishaji

$forward * - nambari ya simu ambayo unataka kuelekeza

* inahitajika tu ikiwa parameta iliyopitishwa na getNumber forward=1.

$status - hali ya uanzishaji

1 - arifu kuhusu upatikanaji wa nambari (SMS imetumwa kwenye nambari)

3 - omba msimbo mwingine (bila malipo)

6 - maliza uanzishaji *

8 - ripoti ukweli kwamba nambari tayari imetumika na ufute uanzishaji

* ikiwa kulikuwa na hali 'msimbo umepokelewa' - inaialamu kama imefanikiwa na kukamilisha, ikiwa kulikuwa na 'maandalizi' - inafuta na kuashiria kosa, ikiwa kulikuwa na hali 'kusubiri kujaribu tena' - inahamisha uanzishaji hadi SMS isubiri

** Haiwezekani kubadilisha hali ya uanzishaji ambayo njia ya uthibitishaji kwa kupiga simu ilichaguliwa ikiwa nambari tayari imefika

Mantiki rahisi ya mpangilio wa kazi na API:

Kupata nambari kwa kutumia njia ya getNumber, kisha hatua zifuatazo zinapatikana:

8 - ghairi uanzishaji (ikiwa nambari haifai kwako)

1 - arifu kwamba SMS imetumwa (si lazima)

Kwa uanzishaji wenye hali 1:

8 - ghairi uanzishaji

Mara baada ya kupokea msimbo:

3 - omba SMS nyingine

6 - thibitisha msimbo wa SMS na umalize uanzishaji

Kwa uanzishaji wenye hali 3:

6 - thibitisha msimbo wa SMS na umalize uanzishaji

JIBU:

ACCESS_READY - uandaaji wa nambari umethibitishwa

ACCESS_RETRY_GET - inasubiri SMS mpya

ACCESS_ACTIVATION - huduma imewezeshwa kwa mafanikio

ACCESS_CANCEL - uwezeshaji umeghairiwa

MAKOSA YANAYOWEZEKANA:

EARLY_CANCEL_DENIED - hairuhusiwi kughairi nambari ndani ya dakika 2 za kwanza

ERROR_SQL - hitilafu ya sql-server

NO_ACTIVATION - kitambulisho cha uwezeshaji hakipo

BAD_SERVICE - jina la huduma lisilo sahihi

BAD_STATUS - hali si sahihi

BAD_KEY - ufunguo wa API usio sahihi

BAD_ACTION - kitendo kisicho sahihi

WRONG_ACTIVATION_ID - Kitambulisho (ID) si sahihi au sio nambari.

Pata hali ya uanzishaji
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id

Vigezo:

$api_key - Kitufe cha API

$id - Kitambulisho cha Uanzishaji

JIBU:

STATUS_WAIT_CODE - inasubiri SMS

STATUS_WAIT_RETRY: 'iliyopita, msimbo uliolingana' - inasubiri ufafanuzi wa msimbo

STATUS_WAIT_RESEND - inasubiri kutuma tena SMS *

* programu lazima ibonyeze 'tuma tena SMS' na kubadilisha hali kuwa 6

STATUS_CANCEL - uwezeshaji umeghairiwa

STATUS_OK: 'msimbo wa uwezeshaji' - msimbo umepokelewa

MAKOSA YANAYOWEZEKANA:

NO_ACTIVATION - kitambulisho cha uwezeshaji hakipo

ERROR_SQL - hitilafu ya sql-server

BAD_KEY - ufunguo wa API usio sahihi

BAD_ACTION - kitendo kisicho sahihi

Pata hali ya uanzishaji Toleo la 2
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getStatusV2&id=$id

Vigezo:

$api_key - Kitufe cha API

$id - Kitambulisho cha Uanzishaji

JIBU:

Muundo wa majibu utakuwa kama ifuatavyo:

{
"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 - uwezeshaji umeghairiwa

MAKOSA YANAYOWEZEKANA:

NO_ACTIVATION - kitambulisho cha uwezeshaji hakipo

ERROR_SQL - hitilafu ya sql-server

BAD_KEY - ufunguo wa API usio sahihi

BAD_ACTION - kitendo kisicho sahihi

Pata historia ya uanzishaji
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getHistory&start=$start&end=$end&offset=$offset&limit=$limit

Vigezo:

$api_key - Kitufe cha API

$start - muhuri wa wakati katika muundo wa Unix Timestamp (si lazima) - tarehe ya kuanzia kuhesabu uwezeshaji

$end - muhuri wa wakati katika muundo wa Unix Timestamp (si lazima) - tarehe ya mwisho wa kuhesabu uwezeshaji

$offset - nafasi ya kipengele cha kwanza kilichorejeshwa katika jibu. Chaguo-msingi ni 0

$limit - idadi ya juu zaidi ya rekodi zilizorejeshwa. Kiwango cha juu ni 100. Chaguo-msingi ni 50.

JIBU:

Muundo wa majibu utakuwa kama ifuatavyo:

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

MAKOSA YANAYOWEZEKANA:

ERROR_SQL - hitilafu ya sql-server

BAD_KEY - ufunguo wa API usio sahihi

BAD_ACTION - kitendo kisicho sahihi

Pata nchi 10 bora kulingana na huduma
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getListOfTopCountriesByService&service=$service

Vigezo:

$api_key - Kitufe cha API

$service - jina la huduma

JIBU:

Muundo wa majibu utakuwa kama ifuatavyo:

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

MAKOSA YANAYOWEZEKANA:

ERROR_SQL - hitilafu ya sql-server

BAD_KEY - ufunguo wa API usio sahihi

WRONG_SERVICE - huduma si sahihi

BAD_ACTION - kitendo kisicho sahihi

Pata hali ya simu inayoingia
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getIncomingCallStatus&activationId=$id

Vigezo:

$api_key - Kitufe cha API

$id - Kitambulisho cha Uanzishaji

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

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

HALI ZINAZOWEZEKANA:

2 - uwezeshaji mpya

3 - imekamilika kwa mafanikio

4 - imeghairiwa

5 - imerudishwa

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

INVALID_ACTIVATION_ID - Kitambulisho batili cha uanzishaji

Pata bei za sasa kwa nchi
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

Vigezo:

$api_key - Kitufe cha API

$serviceJina fupi la huduma (Hiari, kwa chaguo-msingi huduma zote) tazama jedwali

$countryJina la msimbo wa nchi (Hiari, kwa chaguo-msingi nchi zote) tazama jedwali

JIBU:

JSON - kitu katika muundo
{"Nchi":{"Huduma":{"gharama":Gharama,"idadi":Idadi}}}

Pata bei za kisasa za huduma za uthibitishaji
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getPricesVerification&service=$service

Vigezo:

$api_key - Kitufe cha API

$serviceJina fupi la huduma (Hiari, kwa chaguo-msingi huduma zote) tazama jedwali

JIBU:

JSON - kitu katika muundo
{"Huduma":{"Nchi":{"idadi":Kiasi,"bei":"Bei"}}}

Pata orodha ya nchi zote
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getCountries

Vigezo:

$api_key - Kitufe cha API

JIBU:

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

ambapo (

id : kitambulisho cha nchi;

rus : jina la nchi kwa Kirusi;

eng : jina la nchi kwa Kiingereza;

chn : jina la nchi kwa Kichina;

visible : 0 - nchi haionyeshwi kwenye tovuti, 1 - inaonyeshwa;

retry : 0 - SMS ya kurudia HAIpatikani, 1 - inapatikana;

rent : 0 - nchi haijakodishwa, 1 - imekodishwa;

multiService : 0-nchi HAIPATIKANI kwa huduma nyingi, 1- inapatikana.)

Pata orodha ya huduma zote
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getServicesList

Vigezo:

$api_key- Kitufe cha API

$country *- Kitambulisho cha Nchi. Ikiwa umetoa nchi, tunarudisha huduma zenye bei kwa nchi uliyochagua

$lang *- ni lugha gani itumike kutoa `jina`. Thamani zinazowezekana: 'ru', 'en', 'es', 'cn'. Chaguo-msingi ni 'en'

* kigezo cha hiari

JIBU:

JSON - kitu katika muundo { "status": "success", "services": [ { "code": "aoo", "name": "Pegasus Airlines" } ] }

Huduma ya ziada kwa nambari zilizoelekezwa upya

Baada ya kupokea SMS ya kwanza kwa nambari zilizoelekezwa upya, unaweza kununua huduma zingine zinazohusiana kama vile Yula, Yandex, Avito, au nyingine yoyote

Gharama ya huduma ya ziada ni 5p tu

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

Vigezo:

$api_key - Kitufe cha API

$service - kwa jina fupi la huduma, angalia jedwali tazama jedwali

$id - Kitambulisho cha Uanzishaji wa Mzazi

JIBU:

ADDITIONAL:$id:$phone - uanzishaji mpya umefanikiwa kuundwa. Ambapo ID ni Kitambulisho cha uanzishaji wa ziada, simu ni nambari ya simu

MAKOSA YANAYOWEZEKANA:

WRONG_ADDITIONAL_SERVICE - Huduma batili ya ziada (ni huduma za uelekezaji pekee zinazoruhusiwa)

WRONG_ACTIVATION_ID - Kitambulisho batili cha uanzishaji wa mzazi

WRONG_SECURITY - hitilafu imetokea wakati wa kujaribu kutuma kitambulisho cha uanzishaji bila uelekezaji, au uanzishaji uliokamilika/usioamili

REPEAT_ADDITIONAL_SERVICE - hitilafu hutokea wakati wa kujaribu kuagiza tena huduma iliyonunuliwa NO_BALANCE - Fedha hazitoshi

ERROR_SQL- hitilafu ya hifadhidata, wasiliana na huduma kwa wateja

Uanzishaji upya wa nambari ya virtual

Ikiwa umefanya uanzishaji uliofanikiwa kwenye nambari hiyo, basi unaweza kuifanya tena.

Gharama ya uanzishaji wa ziada huamuliwa kulingana na nchi na huduma. Gharama mahususi inaweza kupatikana kutoka .

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

Vigezo:

$api_key - Kitufe cha API

$activationId - Kitambulisho cha Uanzishaji wa Mzazi

JIBU:

ACCESS_NUMBER:$id:$phone - uanzishaji mpya umefanikiwa kuundwa. Ambapo $id ni Kitambulisho cha uanzishaji wa ziada, $phone ni nambari ya simu

MAKOSA YANAYOWEZEKANA:

RENEW_ACTIVATION_NOT_AVAILABLE- nambari haipatikani kwa uanzishaji wa ziada

WRONG_ACTIVATION_ID - Kitambulisho batili cha uanzishaji wa mzazi

ERROR_SQL- hitilafu ya hifadhidata, wasiliana na huduma kwa wateja

NEW_ACTIVATION_IMPOSSIBLE- haiwezekani kufanya uanzishaji wa ziada

NO_BALANCE - hakuna pesa kwenye akaunti

Pata bei ya uanzishaji wa nambari ya ziada

Unaweza kujua upatikanaji wa nambari kwa uanzishaji wa ziada na kupata gharama yake

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

Vigezo:

$api_key - Kitufe cha API

$activationId - Kitambulisho cha Uanzishaji wa Mzazi

JIBU:

JSON - kitu katika muundo {'status': 'success', 'cost':200,"service":"tw","phone":777777777,"country":14},

MAKOSA YANAYOWEZEKANA:

RENEW_ACTIVATION_NOT_AVAILABLE- nambari haipatikani kwa uanzishaji wa ziada

WRONG_ACTIVATION_ID - Kitambulisho batili cha uanzishaji wa mzazi

SIM_OFFLINE - Kadi ya SIM haiko mtandaoni

Uchambuzi wa sauti mara kwa mara
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=parseCall&id=$id&newLang=$newLang

Vigezo:

$api_keyufunguo wa API

$id - Kitambulisho cha Uanzishaji

$newLang - lugha mpya ya uchambuzi tazama jedwali

JIBU:

Muundo wa majibu utakuwa kama ifuatavyo:

{
"result": "OK"
}

STATUS_CANCEL - uwezeshaji umeghairiwa

NO_CALL- hakuna simu iliyopokelewa

PARSE_COUNT_EXCEED- kikomo cha idadi ya majaribio ya uchambuzi (kiwango cha juu ni 4)

MAKOSA YANAYOWEZEKANA:

WRONG_ACTIVATION_ID - kitambulisho batili, uanzishaji haupo

ERROR_SQL - hitilafu ya sql-server

BAD_KEY - ufunguo wa API usio sahihi

BAD_ACTION - kitendo kisicho sahihi

Kukodisha API

Omba nchi na huduma zinazopatikana
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getRentServicesAndCountries&rent_time=$time&operator=$operator&country=$country&incomingCall=$incomingCall

Vigezo:

$api_key - Kitufe cha API

$time* - muda wa kukodisha (kwa chaguo-msingi: saa 4)

$operator* - mtandao wa simu za mkononi wa nambari, unaweza kubainisha kadhaa zikiwa zimetenganishwa kwa koma (kwa chaguo-msingi: Yoyote)

$country* - nchi (kwa chaguo-msingi: Urusi)

$incomingCall * - ikiwa imehamishwa "true"pata nambari inayounga mkono kipengele cha kupokea simu

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

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

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

OUT_OF_STOCK - nambari za nchi hiyo hazipatikani

Agiza kukodisha nambari ya virtual
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

Vigezo:

$api_key - Kitufe cha API

$service - huduma ambayo unahitaji kupata nambari yake

$time* - muda wa kukodisha kwa saa (chaguo-msingi: saa 4). Kipindi kinachofuata kilichopo ni saa 12, kisha saa 24. Unapoomba kukodisha kwa siku au zaidi, lazima uhamishe: 24, 48, 72, nk.

$operator* - mtandao wa simu za mkononi wa nambari, unaweza kubainisha kadhaa zikiwa zimetenganishwa kwa koma (kwa chaguo-msingi: Yoyote)

$country* - nchi (kwa chaguo-msingi: Urusi)

$url * - kiungo cha webhook (hakizingatiwi kwa chaguo-msingi)

$incomingCall * - ikiwa imehamishwa "true"pata nambari inayounga mkono kipengele cha kupokea simu

WebHook ni nini?

* parameta ya hiari. Ikiwa haijabainishwa, parameta ya chaguo-msingi itatumika.

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

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

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

Jibu katika umbizo la json:

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


Majibu yanayowezekana katika sehemu "message":

BAD_SERVICE - huduma haijabainishwa au jina si sahihi

NO_BALANCE - hakuna pesa kwenye akaunti

NO_NUMBERS - hakuna nambari

ACCOUNT_INACTIVE - hakuna nambari

SERVER_ERROR - hitilafu ya seva

CHANNELS_LIMIT - akaunti imezuiwa

pata hali ya kukodisha
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getRentStatus&id=$id&page=$page&size=$size

Vigezo:

$api_key - Kitufe cha API

$id - Kitambulisho cha kukodisha kilichopokelewa katika jibu wakati wa kuagiza nambari

$page* - nambari ya ukurasa ambapo uteuzi unaanza (unambarua wa kurasa huanzia 0, kutoka mpya kwenda zamani; chaguo-msingi ni 0)

$size* - ukubwa wa ukurasa (chaguo-msingi 10)

* parameta ya hiari. Ikiwa haijabainishwa, parameta ya chaguo-msingi itatumika.

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

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

* mafanikio yanapatikana tu pale panapokuwa na SMS (sanduku 'quantity' > 0).

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

Jibu katika umbizo la json:

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

Majibu yanayowezekana katika sehemu "message":

NO_ID_RENT - kitambulisho cha kukodisha hakijabainishwa

INVALID_PHONE - nambari imekodishwa si na wewe (kitambulisho cha kukodisha batili)

STATUS_FINISH - malipo ya kukodisha yamelipwa na kukamilika

STATUS_CANCEL - kukodisha kumeghairiwa na fedha zimerudishwa

STATUS_WAIT_CODE - kusubiri SMS ya kwanza

STATUS_REVOKE - Nambari imezuiwa, fedha zako zimerudishwa

Mabadiliko ya Hali ya Kukodisha
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=setRentStatus&id=$id&status=$status

Vigezo:

$api_key - Kitufe cha API

$id - Kitambulisho cha kukodisha kilichopokelewa katika jibu wakati wa kuagiza nambari

$status - msimbo wa kubadilisha hali (nambari)

Hali inaweza kuwa:

1
Maliza
2
Ghairi

JIBU:

Jibu la huduma litakuwa katika muundo wa json:

{ "status": "success" }

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

Jibu katika umbizo la json:

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

Majibu yanayowezekana katika sehemu "message":

NO_ID_RENT - kitambulisho cha kukodisha hakijabainishwa

INCORECT_STATUS - hali haipo au imewekwa vibaya

CANT_CANCEL - haiwezekani kughairi mkataba wa kukodisha (zaidi ya dakika 20)

INVALID_PHONE - nambari imekodishwa si na wewe (kitambulisho cha kukodisha batili)

ALREADY_FINISH - mkataba wa kukodisha umeshakamilika

ALREADY_CANCEL - mkataba wa kukodisha umeshaghairiwa

SERVER_ERROR - hitilafu ya seva

Orodhesha uanzishaji wa sasa
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getRentList

👉Tahadhari! Njia hii inaonyesha nambari 10 za mwisho tu. Ikiwa unahitaji nambari zaidi, tumia getRentStatus njia ya kuchunguza hali.

Vigezo:

$api_key - Kitufe cha API

JIBU:

Jibu la huduma litakuwa katika muundo wa json:

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

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

BAD_ACTION - kitendo kisicho sahihi


Jibu katika umbizo la json:

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


Majibu yanayowezekana katika sehemu "message":

NO_NUMBERS - hakuna nambari zilizokodishwa

SERVER_ERROR - hitilafu ya seva

Panua muda wako wa kukodisha
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=continueRentNumber&id=$id&rent_time=$time

Vigezo:

$api_key - Kitufe cha API

$id - kitambulisho cha kukodisha

$rent_time- muda wa kukodisha (kwa chaguo-msingi: saa 4)

JIBU:

Jibu la huduma litakuwa katika muundo wa json:

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

Wakati mkataba uliokamilika unapoongezwa muda, utapangwa upya, na kitambulisho kipya kitatolewa

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

BAD_ACTION - kitendo kisicho sahihi

SERVER_ERROR - hitilafu ya seva


Jibu katika umbizo la json:

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


Majibu yanayowezekana katika sehemu "message":

NO_ID_RENT - hakuna kitambulisho cha kukodisha

INVALID_TIME - muda usio sahihi. Idadi ya saa zinazopatikana ni kutoka 4 hadi 1344

MAX_HOURS_EXCEED - Muda wa juu unaopatikana umezidiwa

taarifa:

juu - muda wa juu unaopatikana

INVALID_PHONE - kitambulisho batili cha kukodisha

RENT_DIE - kukodisha hakuwezi kuongezwa kwa sababu nambari imeisha muda wake

NO_BALANCE - fedha hazitoshi

CHANNELS_LIMIT - akaunti imezuiwa

Pata gharama ya kuongeza muda wa kukodisha
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=getContinueRentPriceNumber&id=$id&rent_time=$time

* njia hii inapatikana tu kwa kukodisha na mtandao wa MTT.

Vigezo:

$api_key - Kitufe cha API

$id - kitambulisho cha kukodisha

$rent_time - muda wa kukodisha

JIBU:

Jibu la huduma litakuwa katika muundo wa json:

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

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

BAD_ACTION - kitendo kisicho sahihi

SERVER_ERROR - hitilafu ya seva


Jibu katika umbizo la json:

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


Majibu yanayowezekana katika sehemu "message":

NO_ID_RENT - hakuna kitambulisho cha kukodisha

INVALID_PHONE - kitambulisho batili cha kukodisha

INVALID_TIME - mipangilio ya muda si sahihi

RENT_DIE - kukodisha hakuwezi kuongezwa kwa sababu nambari imeisha muda wake

MAX_HOURS_EXCEED - Muda wa juu unaopatikana umezidiwa

taarifa:

juu - muda wa juu unaopatikana

CHANNELS_LIMIT - akaunti imezuiwa

API JAVA

Mwanzo wa kazi

Jumuisha maktaba katika maven

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

Unaweza kuona mfano wa usajili kupitia kiungo cha MavenRepository

Ingiza darasa kuu ili kuingiliana na API ya SMS-Activate.

import ru.sms_activate.SMSActivateApi

Ili kutumia maktaba, unahitaji ufunguo wa API, unaweza kupata kwenye ukurasa huu na kwenye kiungo kilicho hapa chini.

Ufunguo wa API wa SMS-Activate
Mfano wa kufanya kazi na salio

Ili kupata salio la sasa kwenye akaunti yako, tumia njia getBalance... Ikiwa unavutiwa na cashback pamoja na salio, basi piga simu kwa njia getBalanceAndCashBack.

Njia getBalanceAndCashBack inarudisha kitu cha darasaSMSActivateGetBalanceAndCashBack.

getBalance: Pata salio la sasa la akaunti

Vigezo:

HAKUNA

AINA YA KURUDISHA:

BigDecimal

getBalanceAndCashBack: Pata salio na kiasi cha cashback kama jumla ya salio

Vigezo:

HAKUNA

getNumber: Pata uanzishaji

Vigezo:

countryId(Integer) - kitambulisho cha nchi.

service(String) - jina fupi la huduma.

forward*(boolean) - iwapo utaomba nambari yenye uelekezaji wa simu.

operatorSet*(Set) - seti ya waendeshaji.

phoneException*(Set) - isipokuwa viambishi awali vya Urusi pekee, seti ya nambari kutoka 3 hadi 6 (7918,7900111).

* sanduku la hiari. Ikiwa hakuna kilichobainishwa, kiasi chaguo-msingi kitatolewa kulingana na mpangilio katika wasifu.

AINA YA KURUDISHA:

SMSActivateActivation

getNumberStatus: Pata taarifa kuhusu huduma zinazopatikana

Vigezo:

countryId(Integer) - kitambulisho cha nchi.

operatorSet*(Set) - seti ya waendeshaji ambao wanapatikana kwa huduma

AINA YA KURUDISHA:

SMSActivateGetNumbersStatus

getAdditionalService: Hurudisha huduma ya ziada kwa nambari ya uelekezaji wa simu.

Vigezo:

id(Integer) - kitambulisho cha uanzishaji

service(String) - jina fupi la huduma.

Badala ya kitambulisho cha uanzishaji, unaweza kupitisha kitu cha darasa kilichopokelewa SMSActivateActivation baada ya kutumia njia getNumber au moja ya uanzishaji baada ya matumizi getMultiServiceNumber.

AINA YA KURUDISHA:

SMSActivateGetNumbersStatus

getMultiServiceNumber: Pata uanzishaji kwa huduma nyingi

Vigezo:

countryId(Integer) - kitambulisho cha nchi.

serviceMap(Set) - seti ya huduma ambazo uanzishaji wake umenunuliwa

multiForwardList(List) - orodha ya huduma zenye uelekezaji wa simu unaopatikana

operatorSet(Set) - seti ya waendeshaji.

getAllPrices: Pata orodha kamili ya bei za uanzishaji

Vigezo:

HAKUNA

AINA YA KURUDISHA:

SMSActivateGetPriceInfo

getPricesByCountryIdAndServiceShortName: Pata orodha ya bei za uanzishaji kulingana na nchi na huduma

Vigezo:

countryId(Integer) - kitambulisho cha nchi.

service(String) - jina fupi la huduma.

AINA YA KURUDISHA:

SMSActivateGetPriceInfo

getPricesAllServicesByCountryId: Pata orodha ya bei za uanzishaji kulingana na nchi

Vigezo:

countryId(Integer) - kitambulisho cha nchi.

AINA YA KURUDISHA:

SMSActivateGetPriceInfo

getStatus: Pata hali ya uanzishaji

Vigezo:

activationId(Integer) - kitambulisho cha uanzishaji

Badala ya kitambulisho cha uanzishaji, unaweza kupitisha kitu cha darasa kilichopokelewa SMSActivateActivation baada ya kutumia njia getNumber au moja ya uanzishaji baada ya matumizi getMultiServiceNumber.

AINA YA KURUDISHA:

SMSActivateGetStatusResponse

setStatus: Weka hali ya uanzishaji

Vigezo:

id(Integer) - kitambulisho cha uanzishaji

status(SMSActivateClientStatus) - hali ambayo inapaswa kuwekwa kwa uanzishaji

Badala ya kitambulisho cha uanzishaji, unaweza kupitisha kitu cha darasa kilichopokelewa SMSActivateActivation baada ya kutumia njia getNumber au moja ya uanzishaji baada ya matumizi getMultiServiceNumber.

AINA YA KURUDISHA:

SMSActivateSetStatusResponse

getCountries: Pata taarifa kuhusu nchi

Vigezo:

HAKUNA

AINA YA KURUDISHA:

SMSActivateGetCountriesResponse

getFullSms: Pata maandishi kamili ya SMS kutoka kwa nambari

Vigezo:

activationId(Integer) - kitambulisho cha uanzishaji

Badala ya kitambulisho cha uanzishaji, unaweza kupitisha kitu cha darasa kilichopokelewa SMSActivateActivation baada ya kutumia njia getNumber au moja ya uanzishaji baada ya matumizi getMultiServiceNumber.

AINA YA KURUDISHA:

SMSActivateGetFullSmsResponse

Mchakato wa kupokea maandishi kamili ya SMS pamoja na uanzishaji

Kupata nambari kwa kutumia njia ya getNumber, kisha hatua zifuatazo zinapatikana:

CANCEL - 8 - Ghairi uanzishaji (ikiwa nambari haikufaa)

MESSAGE_WAS_SENT - Taarifa kwamba SMS imetumwa (Inahitajika ili kupokea maandishi kamili ya SMS)

Baada ya kuweka hali ya MESSAGE_WAS_SENT kama lazima, weka kigezo cha kupokea SMS kwa kutumia njia ya waitSMS pamoja na vigezo vya uanzishaji na muda wa kusubiri SMS.

Baada ya kupokea SMS, unaweza kuipata kwa kutumia njia ya getFullSMS na kisha kuonyesha maandishi kamili kwa kutumia njia ya getText()

Baada ya hapo, unaweza kuweka uanzishaji katika hali zifuatazo:

Ili kuanzisha kwa hali ya MESSAGE_WAS_SENT:

CANCEL - Ghairi uanzishaji

Mara baada ya kupokea msimbo:

REQUEST_ONE_MORE_CODE - Omba SMS nyingine

FINISH - Thibitisha nambari ya SMS na ukamilishe uanzishaji

Ili kuanzisha kwa hali ya REQUEST_ONE_MORE_CODE:

FINISH - Thibitisha nambari ya SMS na ukamilishe uanzishaji

getRentNumber: Pata nambari yenye chaguo la kukodisha

Vigezo:

countryId(Integer) - kitambulisho cha nchi.

service(String) - jina fupi la huduma.

hours(Integer)* - muda wa kukodisha

operator(String)* - jina la mtandao wa simu

urlWebhook(String)* - kiungo cha webhook (Haitazingatiwa chaguomsingi)

WebHook ni nini?

* kigezo cha hiari. Ikiwa hakijatajwa, chaguomsingi kitakuwa

AINA YA KURUDISHA:

SMSActivateRentActivation

GetRentServicesAndCountriesRun: Pata huduma na nchi za kukodisha

Vigezo:

countryId(Integer) - kitambulisho cha nchi.

operatorSet(Set) - seti ya mitandao ya simu

hours(Integer)* - muda wa kukodisha

* kigezo cha hiari. Ikiwa hakijatajwa, chaguomsingi kitakuwa

GetRentStatusJava: Pata hali ya kukodisha

Vigezo:

rentId(Integer) - kitambulisho cha nambari iliyokodishwa

Badala ya rentId, unaweza kupitisha kitu cha darasa kilichopatikana SMSActivateRentActivation baada ya kutumia njia getRentNumber

AINA YA KURUDISHA:

SMSActivateRentStatus

Email API

Maelezo ya hali za API

3 - Inasubiri

4 - Imeghairiwa

5 - Imefanikiwa

Mail API Toleo la 2

MAELEZO:

Kufuata kwa makini zaidi kanuni za REST API na kuongezeka kwa idadi ya masanduku ya barua pepe ya gmail.com kwa ajili ya kusajili akaunti za Telegram.

Pata orodha yenye ofa
https://api.sms-activate.ai/stubs/handler_api.php?action=getDomains&api_key=$api_key&site=$site

Vigezo:

$api_key - Kitufe cha API

$site- Tovuti ambayo unahitaji barua pepe yake

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

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

MAKOSA YANAYOWEZEKANA:

BAD_SITE- Tovuti haijatajwa

BAD_KEY - ufunguo wa API usio sahihi

BAD_ACTION - kitendo kisicho sahihi

Nunua uthibitishaji kupitia barua pepe
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

Vigezo:

$api_key - Kitufe cha API

$site - tovuti ambayo unahitaji barua pepe yake

$mail_type - aina ya barua pepe: vikoa maarufu au maeneo (1 - maeneo 2 - maarufu)

$mail_domain - eneo au kikoa kilichochaguliwa

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

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

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

BAD_ACTION - kitendo kisicho sahihi

MAIL_TYPE_ERROR - hakuna kikoa kama hicho kwa tovuti iliyotajwa

CHANNELS_LIMIT - akaunti imezuiwa

Uamilisho upya wa barua pepe
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=reorderMailActivation&id=$id

Vigezo:

$api_key - Kitufe cha API

$id- Kitambulisho cha barua pepe ambayo inahitaji uamilisho upya

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

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

MAKOSA YANAYOWEZEKANA:

BAD_KEY - ufunguo wa API usio sahihi

BAD_ACTION - kitendo kisicho sahihi

BLOCKED_SITE - tovuti iliyozuiwa

BAD_BALANCE - fedha hazitoshi

ACTIVATION_NOT_FOUND - uamilisho haujapatikana

CHANNELS_LIMIT - akaunti imezuiwa

Pata orodha ya manunuzi yanayofanya kazi
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

Vigezo:

$api_key - Kitufe cha API

$page- nambari ya ukurasa

$per_page- idadi ya manunuzi kwa kila ukurasa

$search- upau wa utafutaji

$sort- mwelekeo wa kupanga. (desc, asc)

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

{
                        "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
                        }
                        }
Ghairi ununuzi wa barua pepe
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=cancelMailActivation&id=$id

Vigezo:

$api_key - Kitufe cha API

$id- kitambulisho cha ununuzi

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

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

MAKOSA YANAYOWEZEKANA:

EARLY_CANCEL_DENIED - Huwezi kughairi barua pepe kwa dakika 2 za kwanza.

Angalia ikiwa barua pepe imepokelewa
https://api.sms-activate.ai/stubs/handler_api.php?api_key=$api_key&action=checkMailActivation&id=$id

Vigezo:

$api_key - Kitufe cha API

$id- kitambulisho cha barua pepe iliyonunuliwa, kinarejeshwa baada ya kununua barua pepe

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

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

Programu ya Mshirika wa API

Nunua programu ya mshirika
https://api.sms-activate.ai/stubs/handler_api.php?action=buyPartnerProduct&productId=$id&api_key=$api_key

Vigezo:

$api_key - Kitufe cha API

$id- Kitambulisho cha programu unayohitaji kununua

JIBU:

Jibu la huduma litakuwa katika muundo wa json, mfano:

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

MAKOSA YANAYOWEZEKANA:

BAD_DATA - Kitambulisho si sahihi au kitambulisho si nambari

BAD_ACTION - hatua batili au muuzaji tena hajathibitishwa.

                        <?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 sms-activate.host 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 }}

Zana ya Kuiga Tovuti