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 PythonAPI ya Uanzishaji
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:
** 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.
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
}
}, ...
}
Ombi la salio lenye akaunti ya cashback:
* 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
* 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)
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)
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.
* 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
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
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
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):
$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
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.
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
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
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
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
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
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}}}
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"}}}
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.)
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" } ] }
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
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
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 .
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
Unaweza kujua upatikanaji wa nambari kwa uanzishaji wa ziada na kupata gharama yake
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
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
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
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
* 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
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
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:
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
👉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
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
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
* 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
juu - muda wa juu unaopatikana
CHANNELS_LIMIT - akaunti imezuiwa
API JAVA
Jumuisha maktaba katika maven
<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.
Ili kutumia maktaba, unahitaji ufunguo wa API, unaweza kupata kwenye ukurasa huu na kwenye kiungo kilicho hapa chini.
Ufunguo wa API wa SMS-ActivateIli 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.
Vigezo:
HAKUNA
AINA YA KURUDISHA:
BigDecimal
Vigezo:
HAKUNA
AINA YA KURUDISHA:
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:
Vigezo:
countryId(Integer) - kitambulisho cha nchi.
operatorSet*(Set) - seti ya waendeshaji ambao wanapatikana kwa huduma
AINA YA KURUDISHA:
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:
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.
AINA YA KURUDISHA:
Vigezo:
HAKUNA
AINA YA KURUDISHA:
Vigezo:
countryId(Integer) - kitambulisho cha nchi.
service(String) - jina fupi la huduma.
AINA YA KURUDISHA:
Vigezo:
countryId(Integer) - kitambulisho cha nchi.
AINA YA KURUDISHA:
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:
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:
Vigezo:
HAKUNA
AINA YA KURUDISHA:
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:
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
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:
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
AINA YA KURUDISHA:
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:
Email API
Maelezo ya hali za API
3 - Inasubiri
4 - Imeghairiwa
5 - Imefanikiwa
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.
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
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
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
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
}
}
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.
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
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





















































