SMS-ACTIVATE
Браузер
SMS-Activate сервисімен жұмыс істеуге арналған API хаттамасы
API - бұл сіздің бағдарламаңыз бен біздің серверіңіз арасындағы хаттама
API сіздің тарапыңызда SMS, OTP және PVA алу процесін автоматтандыру үшін қажет
Біздің API толығымен бәсекелес сайттармен үйлесімді
Барлық сұраныстар https://api.sms-activate.ai/stubs/handler_api.php мекенжайына жіберілуі тиіс
POST немесе GET сұранысы.
Барлық сұраныстар api_key GET параметрі түрінде API кілтін қамтуы тиіс
PHP тіліндегі хаттама реализациясын жүктеп алу Python тіліндегі дайын хаттама реализациясын жүктеп алуАктивациялау API
Параметрлер:
$api_key - API кілті
$country * - ел нөмірі кестені қараңыз
$оператор * мобильді оператор нөмірлері, бірнеше нөмірді үтірмен бөліп көрсетуге болады (тек мыналар үшін қолжетімді:
** қолжетімді: $country = 0, $country = 1, $country = 2
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{"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}
Сызықшаға дейін – сервис атауы, ал одан кейін бағыттауды қосу қажеттілігі көрсетіледі. 0 – жоқ. 1 – иә.
Параметрлер:
$api_key - API кілті
$service * - Сервис кестені қараңыз
* міндетті емес параметр. Көрсетілмесе, әдепкі бойынша барлық сервистер үшін үздік елдер тізімі шығады.
$freePrice * - міндетті емес параметр. Егер көрсетілсе true, саны мен бағасы Free Price бойынша анықталады
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{
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
}
}, ...
}
Кэшбэк шотымен баланс сұранысы:
* егер кэшбэк шотының баптауларында «Активацияға кэшбэк жұмсау» құсбелгісі қойылған болса, жиналған кэшбэкті ескере отырып балансты қайтарады
Параметрлер:
$api_key - API кілті
ЖАУАП:
ACCESS_BALANCE: 'шот балансы'
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
ERROR_SQL - SQL-сервер қатесі
* берілген ел үшін қолжетімді барлық операторларды қайтарады; егер ел көрсетілмесе, әр ел үшін қолжетімді барлық операторларды қайтарады
Параметрлер:
$api_key - API кілті
$country - ел коды
ЖАУАП:
Сервис жауабы JSON форматында болады:
{"status":"success", "countryOperators": {
"Country1Code": ["operator1Name","operator2Name","operator3Name", ...],
"Country2Code": ["operator1Name","operator2Name","operator3Name", ...],
...
}}
Мысал:
{"status":"success", "countryOperators": {
"0": ["beeline","megafon","mts", ...],
"1": ["life","mts","kyivstar","utel" ...],
...
}}
* 'countryOperators' ішінде кілт ретінде ел коды болады
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
ERROR_SQL - SQL-сервер қатесі
OPERATORS_NOT_FOUND - деректер табылмады (мысалы, жоқ ел коды берілген)
Параметрлер:
$api_key - API кілті
ЖАУАП:
Сервис жауабы 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",
}]
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
ERROR_SQL - SQL-сервер қатесі
NO_ACTIVATIONS - жазбалар табылмады (белсенді активациялар жоқ)
Параметрлер:
$api_key - API кілті
$service - тапсырыс беру сервисі кестені қараңыз
$forward * - бағыттаумен нөмір сұрау қажет пе
* міндетті емес параметр, 0 (орындалмайды, әдепкі мәні), 1 (орындалады) мәндерін қабылдайды
$maxPrice * - Free Price режимінде нөмірді сатып алуға дайын максималды баға
* міндетті емес параметр; көрсетілмесе, сатып алу қалыпты бағамен жүргізіледі
$phoneException * - Ресей нөмірлері үшін префикстерді алып тастау. Үтір арқылы жазыңыз. Жазба форматы: ел коды және масканың 3-тен 6-ға дейінгі цифрлары (мысалы, 7918, 7900111). Әдепкі мән – шотта көрсетілген мән.
$operator* — нөмірдің мобильді операторы, бірнешеуін үтір арқылы көрсетуге болады (тек ** үшін қолжетімді)
$activationType - активтендіру түрі: 0 - SMS арқылы (әдепкі), 1 - нөмір арқылы, 2 - дауыстық хабарлама арқылы
$language - парсинг тілі (дауыстық активтендіру үшін қажет) кестені қараңыз
$userId * - нашар активтендіру статистикасы үшін тыйым салынатын пайдаланушы ID-сі, бірақ реселлердің өз шотына әсер етпейді.
* міндетті емес өріс
** қолжетімді: $country = 0, $country = 1, $country = 2
$ref - рефералдық ID-ді жіберу.
$country - ел нөмірі кестені қараңыз
$useCashBack* - логикалық мәнді қабылдайды, егер параметр 'true' болса, нөмірді сатып алу кэшбэк балансынан жүргізіледі. Кэшбэк балансындағы қаражат таусылғаннан кейін, барлық келесі сатып алымдар негізгі баланс арқылы жүргізіледі. Барлық келесі сатып алымдар алдымен кэшбэкті, содан кейін негізгі баланды пайдаланады деп есте сақтау МАҢЫЗДЫ (кейіннен 'false' параметрін берсеңіз де).
* міндетті емес параметр, 'true' мәнін қабылдайды
API арқылы нөмір алғанда, сіз келесімен келісесіз жоба ережелері жоба ережелері
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
WRONG_MAX_PRICE:$min- көрсетілген максималды баға рұқсат етілгеннен төмен
$min - минималды рұқсат етілген баға
BAD_ACTION - қате әрекет
BAD_SERVICE - қате сервис атауы
BAD_KEY - жарамсыз API кілті
ERROR_SQL - SQL-сервер қатесі
BANNED:'YYYY-m-d H-i-s' - шот бұғатталған уақыт
WRONG_EXCEPTION_PHONE - қате ерекше префикстер
NO_BALANCE_FORWARD - қоңырауды қайта бағыттауды сатып алуға қаражат жеткіліксіз
CHANNELS_LIMIT - шот бұғатталды
NO_NUMBERS - нөмірлер жоқ
Егер сіз таңдалған елде жұмыс істемейтін немесе таңдалған сервисті қолдамайтын нақты оператордың нөмірін алуды сұрасаңыз, сұраныс параметрлеріне сәйкес келетін бірінші оператордың нөмірі қайтарылады
бұл әдіс әдіске ұқсас жұмыс істейді getNumber, төменде сипатталған сол параметрлер мен қосымша параметрлерді қабылдайды, бірақ қосымша активтендіру ақпаратын қайтарады
Параметрлер:
$orderId- реселлер жүйесіндегі активтендіру ID-сі. Сатып алу кезінде бұл деректер біздің жүйедегі активтендіру ID-сі және реселлермен салыстырылады. Осылайша, біз идемпотенттілікке (бірдей тапсырыс қайта өңделмейді) қол жеткізгіміз келеді.
ЖАУАП:
Егер сұраныс сәтті орындалса, жауап келесі форматта болады:
{
"activationId": 635468024,
"phoneNumber": "79584******",
"activationCost": "12.50",
"countryCode": "0",
"canGetAnotherSms": "1",
"activationTime": "2022-06-01 17:30:57",
"activationOperator": "mtt"
}
Егер сіз таңдалған елде жұмыс істемейтін немесе таңдалған сервисті қолдамайтын нақты оператордың нөмірін алуды сұрасаңыз, сұраныс параметрлеріне сәйкес келетін бірінші оператордың нөмірі қайтарылады
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
ORDER_ALREADY_EXISTS- тапсырыс бұрыннан жасалған
Сіз номерге SMS алған кезде, егер параметрлерде Webhooks функциясын қосқан болсаңыз, біз SMS туралы ақпаратты сіз көрсеткен мекенжайларға POST сұранысы арқылы жібереміз
ЖАУАП:
Жауап форматы келесідей болады:
{
"activationId": 635468024,
"service": "go",
"text": "Your sms text",
"code": "Your sms code",
"country": 0,
"receivedAt": "2022-06-01 17:30:57",
}
Сұраныс жіберген кезде, біз сіздің скриптіңізден HTTP статусы 200 болатын жауапты күтеміз. Егер сіздің скриптіңіз жауап бермесе, біз 2 сағат ішінде, бірақ 8 реттен аспайтын сұраныс жібереміз.
Бұл функцияны келесі жерден қосуға болады профиль параметрлері
Параметрлер:
$api_key - API кілті
$service - тапсырыс беру сервисі кестені қараңыз
$forward * - бағыттаумен нөмір сұрау қажет пе
* міндетті емес параметр, бағыттау таңбалары үтірмен бөлінеді, бағыттау цифрларының саны параметрде берілген қызметтер санына сәйкес келуі керек $service. Бағыттаумен тек 1 қызметті жіберуге болады, мысалы "0,1,0,0" - дұрыс, "0,1,1,0" - қате. 0 (орындамау, әдепкі бойынша), 1 (орындау) мәндерін қабылдайды
$operator * - номердің мобильді операторы, бірнеше номерді үтірмен бөліп көрсетуге болады (тек ** үшін қолжетімді):
$ref - рефералдық ID-ді жіберу.
$country - ел нөмірі кестені қараңыз
API арқылы нөмір алғанда, сіз келесімен келісесіз жоба ережелері жоба ережелері
ЖАУАП:
NO_NUMBERS - нөмірлер жоқ
NO_BALANCE - баланс таусылды
{{'phone':phone,'activation':activation,'service':service},
{'phone':phone,'activation':activation,'service':service}}, мұндағы (phone - операция ID, activation - Телефон номері, service - Қызмет)
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_ACTION - қате әрекет
BAD_SERVICE - қате сервис атауы
BAD_KEY - жарамсыз API кілті
ERROR_SQL - SQL-сервер қатесі
BANNED:'YYYY-m-d H-i-s' - шот бұғатталған уақыт
Параметрлер:
$api_key - API кілті
$id - Активтендіру ID
$forward * - сіз бағыттауды қалайтын телефон номері
* тек getNumber forward=1 параметрі берілген жағдайда қажет.
$status - активтендіру статусы
1 - номердің қолжетімділігі туралы хабарлау (номерге SMS жіберілді)
3 - тағы бір кодты сұрау (тегін)
6 - активтендіруді аяқтау *
8 - номердің бұрын пайдаланылғаны туралы хабарлау және активтендіруді болдырмау
* егер 'код алынды' статусы болса - оны сәтті деп белгілейді және аяқтайды, егер 'дайындық' болса - жояды және қате деп белгілейді, егер 'қайталауды күту' статусы болса - активтендіруді SMS күту режиміне ауыстырады
** Егер номер келіп түссе, шақыру арқылы тексеру әдісі таңдалған активтендіру статусын өзгерту мүмкін емес
API-мен жұмыс істеу хронологиясының қарапайым логикасы:
getNumber әдісі арқылы номер алу, содан кейін келесі әрекеттер қолжетімді:
8 - активтендіруді болдырмау (егер номер сізге сәйкес келмесе)
1 - SMS жіберілгенін хабарлау (міндетті емес)
Статусы 1 болатын активтендіру үшін:
8 - активтендіруді болдырмау
Кодты алғаннан кейін дереу:
3 - тағы бір SMS сұрау
6 - SMS-кодты растау және активтендіруді аяқтау
Статусы 3 болатын активтендіру үшін:
6 - SMS-кодты растау және активтендіруді аяқтау
ЖАУАП:
ACCESS_READY - номерлердің дайындығы расталды
ACCESS_RETRY_GET - жаңа SMS күтілуде
ACCESS_ACTIVATION - қызмет сәтті іске қосылды
ACCESS_CANCEL - активтеу тоқтатылды
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
EARLY_CANCEL_DENIED - алғашқы 2 минут ішінде нөмірді болдырмауға тыйым салынған
ERROR_SQL - SQL-сервер қатесі
NO_ACTIVATION - активтеу идентификаторы жоқ
BAD_SERVICE - қате сервис атауы
BAD_STATUS - қате күй
BAD_KEY - жарамсыз API кілті
BAD_ACTION - қате әрекет
WRONG_ACTIVATION_ID - қате ID немесе ID сан емес.
Параметрлер:
$api_key - API кілті
$id - Активтендіру ID
ЖАУАП:
STATUS_WAIT_CODE - SMS күтілуде
STATUS_WAIT_RETRY: 'бұрынғы, сәйкессіз код' - кодты нақтылау күтілуде
STATUS_WAIT_RESEND - SMS қайта жіберілуін күту *
* бағдарлама SMS-ті қайта жіберу түймесін басып, мәртебені 6-ға ауыстыруы керек
STATUS_CANCEL - активтеу тоқтатылды
STATUS_OK: 'активтеу коды' - код алынды
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
NO_ACTIVATION - активтеу идентификаторы жоқ
ERROR_SQL - SQL-сервер қатесі
BAD_KEY - жарамсыз API кілті
BAD_ACTION - қате әрекет
Параметрлер:
$api_key - API кілті
$id - Активтендіру ID
ЖАУАП:
Жауап форматы келесідей болады:
{
"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 - активтеу тоқтатылды
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
NO_ACTIVATION - активтеу идентификаторы жоқ
ERROR_SQL - SQL-сервер қатесі
BAD_KEY - жарамсыз API кілті
BAD_ACTION - қате әрекет
Параметрлер:
$api_key - API кілті
$start - Unix Timestamp форматындағы уақыт белгісі (міндетті емес) - активтеулерді қай күннен бастап ескеру керек
$end - Unix Timestamp форматындағы уақыт белгісі (міндетті емес) - активтеулерді қай күнге дейін ескеру керек
$offset - жауапта қайтарылған бірінші элементтің ығысуы. Әдепкі мәні 0
$limit - қайтарылған жазбалардың максималды саны. Максимум 100. Әдепкі мәні 50.
ЖАУАП:
Жауап форматы келесідей болады:
[{
"id": 635468024,
"date": "2022-11-12 15:58:39",
"phone": "79918529716",
"sms": "sms":"["Your sms code"]",
"cost": 100 //Если активация не завершена, то cost = 0,
"status": "4",
}]
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
ERROR_SQL - SQL-сервер қатесі
BAD_KEY - жарамсыз API кілті
BAD_ACTION - қате әрекет
Параметрлер:
$api_key - API кілті
$service - қызмет атауы
ЖАУАП:
Жауап форматы келесідей болады:
[{
"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)
}]
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
ERROR_SQL - SQL-сервер қатесі
BAD_KEY - жарамсыз API кілті
WRONG_SERVICE - қате қызмет
BAD_ACTION - қате әрекет
Параметрлер:
$api_key - API кілті
$id - Активтендіру ID
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{"status":"2","phone":false}
МҮМКІН МӘРТЕБЕЛЕР:
2 - жаңа активтеу
3 - сәтті аяқталды
4 - бас тартылды
5 - қайтарылды
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
INVALID_ACTIVATION_ID - Қате активтендіру ID-і
Параметрлер:
$api_key - API кілті
$serviceҚызметтің қысқа атауы (Міндетті емес, әдепкі бойынша барлық қызметтер) кестені қараңыз
$countryЕл кодының атауы (Міндетті емес, әдепкі бойынша барлық елдер) кестені қараңыз
ЖАУАП:
JSON - форматтағы объект
{"Country":{"Service":{"cost":Cost,"count":Count}}}
Параметрлер:
$api_key - API кілті
$serviceҚызметтің қысқа атауы (Міндетті емес, әдепкі бойынша барлық қызметтер) кестені қараңыз
ЖАУАП:
JSON - форматтағы объект
{"Service":{"Country":{"count":Quantity,"price":"Price"}}}
Параметрлер:
$api_key - API кілті
ЖАУАП:
JSON - форматтағы объект {{'Страна':{'id':0,'rus':"Россия","eng:"Russia","chn":"俄罗斯","visible":1,"retry":1,"rent":1,"multiService":1}},
мұндағы (
id : ел идентификаторы;
rus : ел атауы орыс тілінде;
eng : ел атауы ағылшын тілінде;
chn : ел атауы қытай тілінде;
visible : 0 - ел сайтта көрсетілмейді, 1 - көрсетіледі;
retry : 0 - қайталама SMS қолжетімсіз, 1 - қолжетімді;
rent : 0 - ел жалға берілмейді, 1 - жалға беріледі;
multiService : 0 - ел мультиқызмет үшін қолжетімсіз, 1 - қолжетімді.)
Параметрлер:
$api_key- API кілті
$country *- Ел ID. Егер сіз елді таңдасаңыз, біз таңдалған ел үшін бағасы бар қызметтерді қайтарамыз
$lang *- `name` мәнін ұсыну үшін қай тілді пайдалану керек. Мүмкін мәндер: 'ru', 'en', 'es', 'cn'. Әдепкі мән - 'en'
* міндетті емес параметр
ЖАУАП:
JSON - форматтағы объект { "status": "success", "services": [ { "code": "aoo", "name": "Pegasus Airlines" } ] }
Бағытталған нөмірлер үшін алғашқы SMS алғаннан кейін, сіз Yula, Yandex, Avito және басқа да байланысты қызметтерді сатып ала аласыз
Қосымша қызметтің құны тек 5 тиын
Параметрлер:
$api_key - API кілті
$service - қызметтің қысқа атауы үшін кестені қараңыз кестені қараңыз
$id - Негізгі активтендіру ID-і
ЖАУАП:
ADDITIONAL:$id:$phone - жаңа активтендіру сәтті жасалды. Мұндағы ID — қосымша активтендірудің ID-і, phone — телефон нөмірі
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
WRONG_ADDITIONAL_SERVICE - Қате қосымша қызмет (тек бағыттау қызметтеріне рұқсат етіледі)
WRONG_ACTIVATION_ID - Қате негізгі активтендіру ID-і
WRONG_SECURITY - Бағыттаусыз активтендіру ID-ін жіберуге немесе аяқталған/бейсенді активтендіруге тырысу кезінде қате орын алды
REPEAT_ADDITIONAL_SERVICE - Сатып алынған қызметті қайта тапсырыс беруге тырысу кезінде қате орын алады NO_BALANCE - Қаражат жеткіліксіз
ERROR_SQL- дерекқор қатесі, клиенттерге қолдау қызметіне хабарласыңыз
Егер сіз нөмір бойынша сәтті активтендіру жасаған болсаңыз, оны қайталай аласыз.
Қосымша активтендірудің құны ел мен қызметке байланысты анықталады. Нақты құнын . арқылы біле аласыз.
Параметрлер:
$api_key - API кілті
$activationId - Негізгі активтендіру ID-і
ЖАУАП:
ACCESS_NUMBER:$id:$phone - жаңа активтендіру сәтті жасалды. Мұндағы $id — қосымша активтендірудің ID-і, $phone — телефон нөмірі
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
RENEW_ACTIVATION_NOT_AVAILABLE- Нөмір қосымша активтендіру үшін қолжетімді емес
WRONG_ACTIVATION_ID - Қате негізгі активтендіру ID-і
ERROR_SQL- дерекқор қатесі, клиенттерге қолдау қызметіне хабарласыңыз
NEW_ACTIVATION_IMPOSSIBLE- Қосымша активтендіру жасау мүмкін емес
NO_BALANCE - шотта ақша жоқ
Сіз нөмірдің қосымша активтендіру үшін қолжетімділігін тексеріп, оның құнын біле аласыз
Параметрлер:
$api_key - API кілті
$activationId - Негізгі активтендіру ID-і
ЖАУАП:
JSON - форматтағы объект {'status': 'success', 'cost':200,"service":"tw","phone":777777777,"country":14},
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
RENEW_ACTIVATION_NOT_AVAILABLE- Нөмір қосымша активтендіру үшін қолжетімді емес
WRONG_ACTIVATION_ID - Қате негізгі активтендіру ID-і
SIM_OFFLINE - SIM карта офлайн режимінде
ЖАУАП:
Жауап форматы келесідей болады:
{
"result": "OK"
}
STATUS_CANCEL - активтеу тоқтатылды
NO_CALL- қоңырау қабылданбады
PARSE_COUNT_EXCEED- парсинг әрекеттерінің шегі (максимум 4)
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
WRONG_ACTIVATION_ID - жарамсыз ID, активтендіру жоқ
ERROR_SQL - SQL-сервер қатесі
BAD_KEY - жарамсыз API кілті
BAD_ACTION - қате әрекет
API жалға алу
Параметрлер:
$api_key - API кілті
$time* - жалға алу уақыты (әдепкі бойынша: 4 сағат)
$operator* - нөмірдің мобильді операторы, бірнешеуін үтірмен бөліп көрсетуге болады (әдепкі бойынша: Кез келгені)
$country* - ел (әдепкі бойынша: Ресей)
$incomingCall * - егер жіберілсе "true"қоңырауды қабылдау функциясын қолдайтын нөмір алыңыз
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{ "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 } } }
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
OUT_OF_STOCK - сол ел үшін нөмірлер қолжетімсіз
Параметрлер:
$api_key - API кілті
$service - нөмір алу қажет болатын қызмет
$time* - жалға алу уақыты сағатпен (әдепкі бойынша: 4 сағат). Келесі қолжетімді уақыт аралығы 12 сағат, содан кейін 24 сағат. Бір күнге немесе одан да ұзақ уақытқа жалға алуды сұрағанда, мыналарды жіберу керек: 24, 48, 72, т.б.
$operator* - нөмірдің мобильді операторы, бірнешеуін үтірмен бөліп көрсетуге болады (әдепкі бойынша: Кез келгені)
$country* - ел (әдепкі бойынша: Ресей)
$url * - вебхукке арналған сілтеме (әдепкі бойынша ескерілмейді)
$incomingCall * - егер жіберілсе "true"қоңырауды қабылдау функциясын қолдайтын нөмір алыңыз
* міндетті емес параметр. Егер көрсетілмесе, әдепкі параметр қолданылады.
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{ "status": "success", "phone": { "id": 1049, "endDate": "2020-01-31T12:01:52", "number": "79959707564" } }
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
JSON форматындағы жауап:
{ "status": "error", "message": "*possible_answer*" }
Өрістегі мүмкін жауаптар "message":
BAD_SERVICE - қызмет көрсетілмеген немесе атауы қате
NO_BALANCE - шотта ақша жоқ
NO_NUMBERS - нөмірлер жоқ
ACCOUNT_INACTIVE - нөмірлер жоқ
SERVER_ERROR - сервер қатесі
CHANNELS_LIMIT - шот бұғатталды
Параметрлер:
$api_key - API кілті
$id - нөмірге тапсырыс бергенде жауапта алынған жалға алу ID-сі
$page* - таңдау басталатын бет нөмірі (беттерді нөмірлеу 0-ден басталады, жаңадан ескіге қарай; әдепкі мәні 0)
$size* - бет өлшемі (әдепкі бойынша 10)
* міндетті емес параметр. Егер көрсетілмесе, әдепкі параметр қолданылады.
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{ "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" } } }
* тек SMS болған жағдайда ғана сәтті орындалады ('quantity' > 0).
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
JSON форматындағы жауап:
{ "status": "error", "message": "*possible_answer*" } Өрістегі мүмкін жауаптар "message": NO_ID_RENT - жалға алу ID-сі көрсетілмеген INVALID_PHONE - нөмір сізге жалға берілмеген (жалға алу ID қате) STATUS_FINISH - жалға алу төленді және аяқталды STATUS_CANCEL - жалға алу қайтарыммен тоқтатылды STATUS_WAIT_CODE - бірінші SMS күтілуде STATUS_REVOKE - нөмір бұғатталды, қаражатыңыз қайтарылды
Параметрлер:
$api_key - API кілті
$id - нөмірге тапсырыс бергенде жауапта алынған жалға алу ID-сі
$status - мәртебені өзгерту коды (нөмір)
Мәртебе келесідей болуы мүмкін:
ЖАУАП:
Сервис жауабы JSON форматында болады:
{ "status": "success" }
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
JSON форматындағы жауап:
{ "status": "error", "message": "*possible_answer*" }
Өрістегі мүмкін жауаптар "message":
NO_ID_RENT - жалға алу ID-сі көрсетілмеген
INCORECT_STATUS - мәртебе жоқ немесе қате көрсетілген
CANT_CANCEL - жалға алуды болдырмау мүмкін емес (20 мин. асты)
INVALID_PHONE - нөмір сізге жалға берілмеген (жалға алу ID қате)
ALREADY_FINISH - жалға алу уже аяқталған
ALREADY_CANCEL - жалға алу уже болдырылмаған
SERVER_ERROR - сервер қатесі
👉Назар аударыңыз! Бұл әдіс тек соңғы 10 нөмірді көрсетеді. Егер сізге көбірек нөмірлер қажет болса, getRentStatus мәртебелерді тексеру үшін әдісін пайдаланыңыз.
Параметрлер:
$api_key - API кілті
ЖАУАП:
Сервис жауабы JSON форматында болады:
{ "status": "success", "values": { "0": { "id": "12345", "phone": "79181234567" }, "1": { "id": "12345", "phone": "79181234568" } } }
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
BAD_ACTION - қате әрекет
JSON форматындағы жауап:
{ "status": "error", "message": "*possible_answer*" }
Өрістегі мүмкін жауаптар "message":
NO_NUMBERS - жалға алынған нөмірлер жоқ
SERVER_ERROR - сервер қатесі
Параметрлер:
$api_key - API кілті
$id - id жалға алу
$rent_time- жалға алу уақыты (әдепкі бойынша: 4 сағат)
ЖАУАП:
Сервис жауабы JSON форматында болады:
{ "status": "success", "phone": { "id": 1049, "endDate": "2020-01-31T12:01:52", "number": "79959707564"} }
Аяқталған жалға алуды ұзартқан кезде, ол қайта тапсырылады, жаңа id беріледі
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
BAD_ACTION - қате әрекет
SERVER_ERROR - сервер қатесі
JSON форматындағы жауап:
{ "status": "error", "message": "*possible_answer*", "info": "*details*" }
Өрістегі мүмкін жауаптар "message":
NO_ID_RENT - жалға алу ID жоқ
INVALID_TIME - қате уақыт. Қолжетімді сағат саны 4-тен 1344-ке дейін
MAX_HOURS_EXCEED - Қолжетімді максималды уақыт асып кетті
макс - максималды қолжетімді уақыт
INVALID_PHONE - қате жалға алу ID
RENT_DIE - жалдау мерзімін ұзарту мүмкін емес, себебі нөмірдің қызмет ету мерзімі аяқталды
NO_BALANCE - қаражат жеткіліксіз
CHANNELS_LIMIT - шот бұғатталды
* бұл әдіс тек MTT операторымен жалға алу кезінде қолжетімді.
Параметрлер:
$api_key - API кілті
$id - id жалға алу
$rent_time - жалдау уақыты
ЖАУАП:
Сервис жауабы JSON форматында болады:
{ "status": "success", "price": 6.33 }
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
BAD_ACTION - қате әрекет
SERVER_ERROR - сервер қатесі
JSON форматындағы жауап:
{ "status": "error", "message": "*possible_answer*" }
Өрістегі мүмкін жауаптар "message":
NO_ID_RENT - жалға алу ID жоқ
INVALID_PHONE - қате жалға алу ID
INVALID_TIME - уақыт параметрлері дұрыс емес
RENT_DIE - жалдау мерзімін ұзарту мүмкін емес, себебі нөмірдің қызмет ету мерзімі аяқталды
MAX_HOURS_EXCEED - Қолжетімді максималды уақыт асып кетті
макс - максималды қолжетімді уақыт
CHANNELS_LIMIT - шот бұғатталды
API JAVA
Maven-ге кітапхананы қосыңыз
<artifactId>SMSActivateApi</artifactId>
<version>1.0</version>
</dependecy>
Тіркелу үлгісін мына жерден көре аласыз MavenRepository сілтемесі
SMS-Activate API-мен жұмыс істеу үшін негізгі классты импорттаңыз.
Кітапхананы пайдалану үшін API кілті қажет, оны осы беттен және төмендегі сілтеме арқылы ала аласыз.
SMS-Activate API-KeyШотыңыздағы ағымдағы теңгерімді алу үшін әдісті пайдаланыңыз getBalance... Егер сіз теңгерімнен бөлек кэшбэкке де мүдделі болсаңыз, онда әдісті шақырыңыз getBalanceAndCashBack.
Әдіс getBalanceAndCashBack класс объектісін қайтарадыSMSActivateGetBalanceAndCashBack.
Параметрлер:
ЖОҚ
ҚАЙТАРУ ТҮРІ:
BigDecimal
Параметрлер:
ЖОҚ
ҚАЙТАРУ ТҮРІ:
Параметрлер:
countryId(Integer) - ел идентификаторы.
service(String) - қызметтің қысқаша атауы.
forward*(boolean) - қоңырауды басқа нөмірге ауыстыру функциясы бар нөмірді сұрау керек пе.
operatorSet*(Жиын) - операторлар жиыны.
phoneException*(Жиын) - тек Ресей үшін префикстерді қоспағанда, 3-тен 6-ға дейінгі сандар жиыны (7918,7900111).
* міндетті емес өріс. Егер ештеңе көрсетілмесе, профильдегі баптауларға сәйкес әдепкі мән беріледі.
ҚАЙТАРУ ТҮРІ:
Параметрлер:
countryId(Integer) - ел идентификаторы.
operatorSet*(Жиын) - қызмет үшін қолжетімді операторлар жиыны
ҚАЙТАРУ ТҮРІ:
Параметрлер:
id(Бүтін сан) - активтеу идентификаторы
service(String) - қызметтің қысқаша атауы.
Активтеу идентификаторының орнына алынған класс объектісін жібере аласыз SMSActivateActivation әдісті қолданғаннан кейін getNumber немесе қолданудан кейінгі активтеулердің бірін getMultiServiceNumber.
ҚАЙТАРУ ТҮРІ:
Параметрлер:
countryId(Integer) - ел идентификаторы.
serviceMap(Жиын) - активтеу сатып алынған қызметтер жиыны
multiForwardList(Тізім) - қоңырауды ауыстыру мүмкіндігі бар қызметтер тізімі
operatorSet(Жиын) - операторлар жиыны.
ҚАЙТАРУ ТҮРІ:
Параметрлер:
ЖОҚ
ҚАЙТАРУ ТҮРІ:
Параметрлер:
countryId(Integer) - ел идентификаторы.
service(String) - қызметтің қысқаша атауы.
ҚАЙТАРУ ТҮРІ:
Параметрлер:
countryId(Integer) - ел идентификаторы.
ҚАЙТАРУ ТҮРІ:
Параметрлер:
activationId(Бүтін сан) - активтеу идентификаторы
Активтеу идентификаторының орнына алынған класс объектісін жібере аласыз SMSActivateActivation әдісті қолданғаннан кейін getNumber немесе қолданудан кейінгі активтеулердің бірін getMultiServiceNumber.
ҚАЙТАРУ ТҮРІ:
Параметрлер:
id(Бүтін сан) - активтеу идентификаторы
status(SMSActivateClientStatus) - активтеу үшін орнатылатын мәртебе
Активтеу идентификаторының орнына алынған класс объектісін жібере аласыз SMSActivateActivation әдісті қолданғаннан кейін getNumber немесе қолданудан кейінгі активтеулердің бірін getMultiServiceNumber.
ҚАЙТАРУ ТҮРІ:
Параметрлер:
ЖОҚ
ҚАЙТАРУ ТҮРІ:
Параметрлер:
activationId(Бүтін сан) - активтеу идентификаторы
Активтеу идентификаторының орнына алынған класс объектісін жібере аласыз SMSActivateActivation әдісті қолданғаннан кейін getNumber немесе қолданудан кейінгі активтеулердің бірін getMultiServiceNumber.
ҚАЙТАРУ ТҮРІ:
Активтеу кезінде SMS-тің толық мәтінін алу алгоритмі
getNumber әдісі арқылы номер алу, содан кейін келесі әрекеттер қолжетімді:
CANCEL - 8 - Активтеуді болдырмау (егер нөмір сізге сәйкес келмесе)
MESSAGE_WAS_SENT - SMS жіберілгенін хабарлау (SMS-тің толық мәтінін алу міндетті)
MESSAGE_WAS_SENT статусын міндетті түрде орнатқаннан кейін, waitSMS әдісі арқылы SMS алу үшін айнымалыны белсендіру параметрлерімен және SMS күту уақытымен бірге орнатыңыз.
SMS алғаннан кейін, оны getFullSMS әдісі арқылы алып, содан кейін getText() әдісі арқылы толық мәтінді көрсетуге болады.
Осыдан кейін сіз белсендірулерді келесі статусқа ауыстыра аласыз:
MESSAGE_WAS_SENT статусымен белсендіру үшін:
CANCEL - Белсендіруді болдырмау
Кодты алғаннан кейін дереу:
REQUEST_ONE_MORE_CODE - Тағы бір SMS сұрау
FINISH - SMS кодын растау және белсендіруді аяқтау
REQUEST_ONE_MORE_CODE статусымен белсендіру үшін:
FINISH - SMS кодын растау және белсендіруді аяқтау
Параметрлер:
countryId(Integer) - ел идентификаторы.
service(String) - қызметтің қысқаша атауы.
hours(Бүтін сан)* - жалға алу уақыты
operator(Жол)* - мобильді оператордың атауы
urlWebhook(Жол)* - вебхукке арналған сілтеме (Әдепкі бойынша ескерілмейді)
WebHook деген не?* қосымша параметр. Көрсетілмесе, әдепкі мән болады
ҚАЙТАРУ ТҮРІ:
Параметрлер:
countryId(Integer) - ел идентификаторы.
operatorSet(Жиын) - мобильді операторлар жиынтығы
hours(Бүтін сан)* - жалға алу уақыты
* қосымша параметр. Көрсетілмесе, әдепкі мән болады
ҚАЙТАРУ ТҮРІ:
Параметрлер:
rentId(Бүтін сан) - жалға алынған нөмірдің идентификаторы
rentId орнына нәтижелік класс объектісін бере аласыз SMSActivateRentActivation әдісті қолданғаннан кейін getRentNumber
ҚАЙТАРУ ТҮРІ:
Email API
API статустарының сипаттамасы
3 - Күтуде
4 - Болдырылды
5 - Сәтті
СИПАТТАМА:
REST API принциптеріне қатаң сәйкестік және Telegram аккаунттарын тіркеу үшін gmail.com пошта жәшіктерінің санын арттыру.
Параметрлер:
$api_key - API кілті
$site- Сізге электрондық пошта қажет сайт
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{
"status":"OK",
"response":{
"zones":[
{
"name":"info",
"cost":2.5
},
...
],
"popular":[
{
"name":"mail.ru",
"cost":6,
"count":159008
},
...
]
}
}
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_SITE- Сайт көрсетілмеген
BAD_KEY - жарамсыз API кілті
BAD_ACTION - қате әрекет
Параметрлер:
$api_key - API кілті
$site - сізге электрондық пошта қажет сайт
$mail_type - пошта түрі: танымал домендер немесе аймақтар (1 - аймақтар 2 - танымал)
$mail_domain - таңдалған аймақ немесе домен
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{
"status":"OK",
"response":{"email":"[email protected]","id":241}
}
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
BAD_ACTION - қате әрекет
MAIL_TYPE_ERROR - көрсетілген сайт үшін мұндай домен жоқ
CHANNELS_LIMIT - шот бұғатталды
Параметрлер:
$api_key - API кілті
$id- Қайта белсендіруді талап ететін пошта идентификаторы
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{
"status": "OK",
"response": {
"email": "[email protected]",
"id": 360
}
}
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_KEY - жарамсыз API кілті
BAD_ACTION - қате әрекет
BLOCKED_SITE - бұғатталған веб-сайт
BAD_BALANCE - қаражат жеткіліксіз
ACTIVATION_NOT_FOUND - белсендіру табылмады
CHANNELS_LIMIT - шот бұғатталды
Параметрлер:
$api_key - API кілті
$page- бет нөмірі
$per_page- әр беттегі сатып алулар саны
$search- іздеу жолағы
$sort- сұрыптау бағыты. (кему, өсу)
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{
"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
}
}
Параметрлер:
$api_key - API кілті
$id- сатып алу идентификаторы
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{
"status":"OK",
"response":true
}
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
EARLY_CANCEL_DENIED - Алғашқы 2 минут ішінде поштаны болдырмау мүмкін емес.
Параметрлер:
$api_key - API кілті
$id- сатып алынған электрондық поштаның идентификаторы, ол сатып алудан кейін қайтарылады
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{
"status":"OK",
"response":{
"value":"Содержания письма"
}
}
API серіктес бағдарламалық жасақтама
Параметрлер:
$api_key - API кілті
$id- Сатып алу қажет бағдарламалық жасақтаманың идентификаторы
ЖАУАП:
Сервис жауабы JSON форматында болады, мысалы:
{
"status": "success",
"key": "F5qrzFoY6afj3zrEq7SeMplbx",
"manual": "Software download link:"
}
ЫҚТИМАЛ ҚАТЕЛІКТЕР:
BAD_DATA - Қате идентификатор немесе идентификатор сан емес
BAD_ACTION - жарамсыз әрекет немесе реселлер тексерілмеген.
<?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.cfd 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