SMS-Activate-এর সাথে কাজ করার জন্য API প্রোটোকল
API হলো আপনার সফটওয়্যার এবং আমাদের সার্ভারের মধ্যে একটি প্রোটোকল
আপনার পক্ষে sms, otp এবং pva গ্রহণের প্রক্রিয়া স্বয়ংক্রিয় করার জন্য API প্রয়োজন
আমাদের API প্রতিযোগী সাইটগুলির সাথে সম্পূর্ণ সামঞ্জস্যপূর্ণ
সমস্ত অনুরোধ https://api.sms-activate.ai/stubs/handler_api.php-তে পাঠাতে হবে
POST বা GET অনুরোধ।
সমস্ত অনুরোধে api_key GET প্যারামিটার হিসেবে একটি API কী থাকতে হবে
PHP-তে প্রোটোকলের বাস্তবায়ন ডাউনলোড করুন Python-এ প্রোটোকলের রেডিমেড বাস্তবায়ন ডাউনলোড করুনঅ্যাক্টিভেশন API
প্যারামিটারসমূহ:
$api_key - API কী
$country * - দেশের নম্বর টেবিল দেখুন
$operator * মোবাইল অপারেটর নম্বর, আপনি কমা দিয়ে আলাদা করা একাধিক নম্বর উল্লেখ করতে পারেন (শুধুমাত্র এর জন্য উপলব্ধ:
** এর জন্য উপলব্ধ $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 * - রাশিয়ান নম্বরের জন্য প্রিফিক্স বাদ দেওয়া। কমা দিয়ে লিখুন। রেকর্ড ফরম্যাট: দেশ কোড এবং মাস্কের ৩ থেকে ৬ সংখ্যা (যেমন 7918, 7900111)। ডিফল্ট মান হলো অ্যাকাউন্টে নির্দিষ্ট করা মান।
$operator* হলো নম্বরটির মোবাইল অপারেটর, আপনি কমা দিয়ে একাধিক অপারেটর উল্লেখ করতে পারেন (শুধুমাত্র ** এর জন্য উপলব্ধ)
$activationType - অ্যাক্টিভেশন টাইপ: 0 - এসএমএস সহ (ডিফল্ট), 1 - নম্বর সহ, 2 - ভয়েস সহ
$language - পার্সিং ভাষা (ভয়েস সহ অ্যাক্টিভেশনের জন্য প্রয়োজনীয়) টেবিল দেখুন
$userId * - খারাপ অ্যাক্টিভেশন পরিসংখ্যানের জন্য ব্যান করার ব্যবহারকারীর আইডি, তবে রিসেলারের নিজস্ব অ্যাকাউন্ট প্রভাবিত হয় না।
* ঐচ্ছিক ফিল্ড
** এর জন্য উপলব্ধ $country = 0, $country = 1, $country = 2
$ref - রেফারেল আইডি ট্রান্সফার করুন।
$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- রিসেলারের সিস্টেম থেকে অ্যাক্টিভেশন আইডি। কেনার সময়, এই ডেটা আমাদের সিস্টেমের অ্যাক্টিভেশন আইডি এবং রিসেলারের সাথে তুলনা করা হয়। এইভাবে, আমরা আইডেম্পোটেন্স অর্জন করতে চাই (একই অর্ডার আবার প্রক্রিয়া করা হবে না)।
উত্তর:
যদি অনুরোধটি সফল হয়, তবে প্রতিক্রিয়া নিম্নলিখিত ফরম্যাটে থাকবে:
{
"activationId": 635468024,
"phoneNumber": "79584******",
"activationCost": "12.50",
"countryCode": "0",
"canGetAnotherSms": "1",
"activationTime": "2022-06-01 17:30:57",
"activationOperator": "mtt"
}
যদি আপনি এমন একটি নির্দিষ্ট অপারেটরের নম্বর পেতে চান যা নির্বাচিত দেশে কাজ করে না বা যার কাছে নির্বাচিত সার্ভিস নেই, তাহলে অনুরোধের প্যারামিটারের সাথে মিলে যাওয়া প্রথম অপারেটরের নম্বর ফেরত দেওয়া হবে
সম্ভাব্য ভুলগুলি:
ORDER_ALREADY_EXISTS- অর্ডারটি ইতিমধ্যে তৈরি করা হয়েছে
আপনি যখন একটি নম্বরে এসএমএস পান, যদি আপনার সেটিংসে ওয়েবহুক ফাংশনালিটি সক্রিয় থাকে, তাহলে আমরা আপনার নির্দিষ্ট করা ঠিকানাগুলোতে POST রিকোয়েস্টের মাধ্যমে এসএমএস সম্পর্কিত তথ্য পাঠাব
উত্তর:
প্রতিক্রিয়ার ফরম্যাট নিম্নরূপ হবে:
{
"activationId": 635468024,
"service": "go",
"text": "Your sms text",
"code": "Your sms code",
"country": 0,
"receivedAt": "2022-06-01 17:30:57",
}
অনুরোধ পাঠানোর সময়, আমরা আপনার স্ক্রিপ্ট থেকে HTTP স্ট্যাটাস 200 সহ প্রতিক্রিয়ার অপেক্ষা করব। যদি আপনার স্ক্রিপ্ট সাড়া না দেয়, তাহলে আমরা ২ ঘন্টার মধ্যে আবার অনুরোধ পাঠাব, কিন্তু সর্বোচ্চ ৮ বারের বেশি নয়।
আপনি এই ফাংশনালিটি সক্রিয় করতে পারেন প্রোফাইল সেটিংসে
প্যারামিটারসমূহ:
$api_key - API কী
$service - অর্ডার করার জন্য সার্ভিস টেবিল দেখুন
$forward * - ফরওয়ার্ডিং সহ একটি নম্বর অনুরোধ করা প্রয়োজন কিনা
* ঐচ্ছিক প্যারামিটার, ফরওয়ার্ডিং ক্যারেক্টারগুলো কমা দ্বারা পৃথক করা হয়, ফরওয়ার্ডিং ডিজিটের সংখ্যা প্যারামিটারে প্রেরিত পরিষেবার সংখ্যার সাথে মিলতে হবে $service. শুধুমাত্র ১টি পরিষেবা রিডাইরেকশন সহ প্রেরণ করা অনুমোদিত, উদাহরণস্বরূপ "0,1,0,0" - সঠিক, "0,1,1,0" - ভুল। 0 (এক্সিকিউট করবেন না, ডিফল্ট), 1 (এক্সিকিউট করুন) গ্রহণ করে
$operator * - নম্বরের মোবাইল অপারেটর, আপনি কমা দ্বারা পৃথক করা একাধিক নম্বর উল্লেখ করতে পারেন (শুধুমাত্র ** এর জন্য উপলব্ধ):
$ref - রেফারেল আইডি ট্রান্সফার করুন।
$country - দেশের নম্বর টেবিল দেখুন
API-এর মাধ্যমে নম্বর পেয়ে, আপনি সম্মত হচ্ছেন প্রকল্পের নিয়মাবলী প্রকল্পের নিয়মাবলী
উত্তর:
NO_NUMBERS - কোনো নম্বর নেই
NO_BALANCE - ব্যালেন্স শেষ হয়ে গেছে
{{'phone':phone,'activation':activation,'service':service},
{'phone':phone,'activation':activation,'service':service}}, যেখানে (phone - অপারেশনের আইডি, activation - ফোন নম্বর, service - পরিষেবা)
সম্ভাব্য ভুলগুলি:
BAD_ACTION - ভুল অ্যাকশন
BAD_SERVICE - ভুল সার্ভিস নাম
BAD_KEY - অবৈধ API কী
ERROR_SQL - SQL-সার্ভার ত্রুটি
BANNED:'YYYY-m-d H-i-s' - যে সময়ের জন্য অ্যাকাউন্টটি ব্লক করা হয়েছে
প্যারামিটারসমূহ:
$api_key - API কী
$id - অ্যাক্টিভেশন আইডি
$forward * - যে ফোন নম্বরে আপনি ফরওয়ার্ড করতে চান
* শুধুমাত্র প্রয়োজনীয় যদি getNumber forward=1 প্যারামিটার সহ প্রেরণ করা হয়েছিল।
$status - অ্যাক্টিভেশন স্ট্যাটাস
1 - নম্বর প্রাপ্যতা সম্পর্কে জানান (নম্বরে এসএমএস পাঠানো হয়েছে)
3 - আরেকটি কোডের অনুরোধ করুন (বিনামূল্যে)
6 - অ্যাক্টিভেশন শেষ করুন *
8 - রিপোর্ট করুন যে নম্বরটি ইতিমধ্যে ব্যবহার করা হয়েছে এবং অ্যাক্টিভেশন বাতিল করুন
* যদি 'কোড প্রাপ্ত' স্ট্যাটাস থাকে - এটি সফলভাবে চিহ্নিত করে এবং সম্পন্ন করে, যদি 'প্রস্তুতি' স্ট্যাটাস থাকে - মুছে ফেলে এবং একটি ত্রুটি চিহ্নিত করে, যদি 'পুনরায় চেষ্টার অপেক্ষায়' স্ট্যাটাস থাকে - অ্যাক্টিভেশনটি এসএমএস পেন্ডিং-এ স্থানান্তর করে
** যদি নম্বরটি ইতিমধ্যে এসে থাকে, তাহলে কলের মাধ্যমে যাচাইকরণ পদ্ধতি নির্বাচিত এমন অ্যাক্টিভেশনের স্ট্যাটাস পরিবর্তন করা সম্ভব নয়
API-এর সাথে কাজ করার ক্রোনোলজির সরল যুক্তি:
getNumber পদ্ধতি ব্যবহার করে একটি নম্বর পাওয়া, তারপর নিম্নলিখিত actions available:
8 - অ্যাক্টিভেশন বাতিল করুন (যদি নম্বরটি আপনার জন্য উপযুক্ত না হয়)
1 - জানান যে এসএমএস পাঠানো হয়েছে (ঐচ্ছিক)
স্ট্যাটাস 1 থাকা অ্যাক্টিভেশনের জন্য:
8 - অ্যাক্টিভেশন বাতিল করুন
কোড পাওয়ার অব্যবহিত পরে:
3 - আরেকটি এসএমএসের অনুরোধ করুন
6 - এসএমএস-কোড নিশ্চিত করুন এবং অ্যাক্টিভেশন শেষ করুন
স্ট্যাটাস 3 থাকা অ্যাক্টিভেশনের জন্য:
6 - এসএমএস-কোড নিশ্চিত করুন এবং অ্যাক্টিভেশন শেষ করুন
উত্তর:
ACCESS_READY - নম্বরের প্রস্তুতি নিশ্চিত করা হয়েছে
ACCESS_RETRY_GET - নতুন SMS-এর জন্য অপেক্ষা করছে
ACCESS_ACTIVATION - সার্ভিসটি সফলভাবে সক্রিয় হয়েছে
ACCESS_CANCEL - অ্যাক্টিভেশন বাতিল করা হয়েছে
সম্ভাব্য ভুলগুলি:
EARLY_CANCEL_DENIED - প্রথম ২ মিনিটের মধ্যে একটি নম্বর বাতিল করা অনুমোদিত নয়
ERROR_SQL - SQL-সার্ভার ত্রুটি
NO_ACTIVATION - অ্যাক্টিভেশন আইডি বিদ্যমান নেই
BAD_SERVICE - ভুল সার্ভিস নাম
BAD_STATUS - ভুল স্ট্যাটাস
BAD_KEY - অবৈধ API কী
BAD_ACTION - ভুল অ্যাকশন
WRONG_ACTIVATION_ID - ভুল আইডি বা আইডি সংখ্যা নয়।
প্যারামিটারসমূহ:
$api_key - API কী
$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 - অ্যাক্টিভেশন আইডি
উত্তর:
প্রতিক্রিয়ার ফরম্যাট নিম্নরূপ হবে:
{
"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 - ইউনিক্স টাইমস্ট্যাম্প ফরম্যাটে টাইমস্ট্যাম্প (ঐচ্ছিক) - কোন তারিখ থেকে অ্যাক্টিভেশনগুলো বিবেচনা করতে হবে
$end - ইউনিক্স টাইমস্ট্যাম্প ফরম্যাটে টাইমস্ট্যাম্প (ঐচ্ছিক) - কোন তারিখ পর্যন্ত অ্যাক্টিভেশনগুলো বিবেচনা করতে হবে
$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 - অ্যাক্টিভেশন আইডি
উত্তর:
সার্ভিসের প্রতিক্রিয়া JSON ফরম্যাটে থাকবে, উদাহরণ:
{"status":"2","phone":false}
সম্ভাব্য স্ট্যাটাসসমূহ:
2 - নতুন অ্যাক্টিভেশন
3 - সফলভাবে সম্পন্ন হয়েছে
4 - বাতিল করা হয়েছে
5 - ফেরত দেওয়া হয়েছে
সম্ভাব্য ভুলগুলি:
BAD_KEY - অবৈধ API কী
অবৈধ অ্যাক্টিভেশন আইডি - অবৈধ অ্যাক্টিভেশন আইডি
প্যারামিটারসমূহ:
$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 - পুনরাবৃত্ত এসএমএস উপলব্ধ নয়, 1 - উপলব্ধ;
rent : 0 - দেশটি লিজ দেওয়া হয়নি, 1 - লিজ দেওয়া হয়েছে;
multiService : 0-দেশটি মাল্টিসার্ভিসের জন্য উপলব্ধ নয়, 1- উপলব্ধ।)
প্যারামিটারসমূহ:
$api_key- API কী
$country *- দেশের আইডি। আপনি যদি দেশ নির্বাচন করেন, আমরা সেই দেশের জন্য মূল্য নির্ধারিত পরিষেবাগুলো ফেরত দেব
$lang *- `name` প্রদানের জন্য কোন ভাষা ব্যবহার করতে হবে। সম্ভাব্য মান: 'ru', 'en', 'es', 'cn'। ডিফল্ট হলো 'en'
* ঐচ্ছিক প্যারামিটার
উত্তর:
JSON - অবজেক্ট ফরম্যাটে { "status": "success", "services": [ { "code": "aoo", "name": "Pegasus Airlines" } ] }
রিডাইরেক্ট করা নম্বরের জন্য প্রথম এসএমএস পাওয়ার পর, আপনি ইউলা, ইয়ানডেক্স, আভিতো বা অন্য যেকোনো সম্পর্কিত সেবা কিনতে পারেন।
অতিরিক্ত সেবার মূল্য মাত্র ৫ পয়েন্ট
প্যারামিটারসমূহ:
$api_key - API কী
$service - সেবার সংক্ষিপ্ত নামের জন্য টেবিলটি দেখুন টেবিল দেখুন
$id - প্যারেন্ট অ্যাক্টিভেশন আইডি
উত্তর:
ADDITIONAL:$id:$phone - একটি নতুন অ্যাক্টিভেশন সফলভাবে তৈরি হয়েছে। যেখানে ID হলো অতিরিক্ত অ্যাক্টিভেশনের আইডি, এবং phone হলো ফোন নম্বর
সম্ভাব্য ভুলগুলি:
WRONG_ADDITIONAL_SERVICE - অবৈধ অতিরিক্ত সেবা (শুধুমাত্র ফরওয়ার্ডিংয়ের জন্য অনুমোদিত সেবাগুলো গ্রহণযোগ্য)
WRONG_ACTIVATION_ID - ভুল প্যারেন্ট অ্যাক্টিভেশন আইডি
WRONG_SECURITY - রিডাইরেকশন ছাড়া অ্যাক্টিভেশন আইডি পাঠানোর চেষ্টা করার সময়, অথবা সম্পন্ন/নিষ্ক্রিয় অ্যাক্টিভেশনের ক্ষেত্রে একটি ত্রুটি ঘটেছে
REPEAT_ADDITIONAL_SERVICE - আগে থেকেই কেনা সেবাটি আবার অর্ডার করার চেষ্টা করলে ত্রুটি হয় NO_BALANCE - পর্যাপ্ত তহবিল নেই
ERROR_SQL- ডাটাবেস ত্রুটি, গ্রাহক সেবার সাথে যোগাযোগ করুন
আপনি যদি নম্বরটিতে সফল অ্যাক্টিভেশন করে থাকেন, তবে আপনি এটি আবার করতে পারেন।
অতিরিক্ত অ্যাক্টিভেশনের মূল্য দেশ এবং সেবার ওপর নির্ভর করে নির্ধারিত হয়। নির্দিষ্ট মূল্য জানতে পারবেন .
প্যারামিটারসমূহ:
$api_key - API কী
$activationId - প্যারেন্ট অ্যাক্টিভেশন আইডি
উত্তর:
ACCESS_NUMBER:$id:$phone - একটি নতুন অ্যাক্টিভেশন সফলভাবে তৈরি হয়েছে। যেখানে $id হলো অতিরিক্ত অ্যাক্টিভেশনের আইডি, $phone হলো ফোন নম্বর
সম্ভাব্য ভুলগুলি:
RENEW_ACTIVATION_NOT_AVAILABLE- নম্বরটি অতিরিক্ত অ্যাক্টিভেশনের জন্য উপলব্ধ নয়
WRONG_ACTIVATION_ID - ভুল প্যারেন্ট অ্যাক্টিভেশন আইডি
ERROR_SQL- ডাটাবেস ত্রুটি, গ্রাহক সেবার সাথে যোগাযোগ করুন
NEW_ACTIVATION_IMPOSSIBLE- অতিরিক্ত অ্যাক্টিভেশন করা সম্ভব নয়
NO_BALANCE - অ্যাকাউন্টে টাকা নেই
আপনি অতিরিক্ত অ্যাক্টিভেশনের জন্য নম্বরের প্রাপ্যতা যাচাই করতে এবং এর মূল্য জানতে পারেন
প্যারামিটারসমূহ:
$api_key - API কী
$activationId - প্যারেন্ট অ্যাক্টিভেশন আইডি
উত্তর:
JSON - অবজেক্ট ফরম্যাটে {'status': 'success', 'cost':200,"service":"tw","phone":777777777,"country":14},
সম্ভাব্য ভুলগুলি:
RENEW_ACTIVATION_NOT_AVAILABLE- নম্বরটি অতিরিক্ত অ্যাক্টিভেশনের জন্য উপলব্ধ নয়
WRONG_ACTIVATION_ID - ভুল প্যারেন্ট অ্যাক্টিভেশন আইডি
SIM_OFFLINE - সিম কার্ড অফলাইন
উত্তর:
প্রতিক্রিয়ার ফরম্যাট নিম্নরূপ হবে:
{
"result": "OK"
}
STATUS_CANCEL - অ্যাক্টিভেশন বাতিল করা হয়েছে
NO_CALL- কোনো কল গ্রহণ করা হয়নি
PARSE_COUNT_EXCEED- পার্সিং প্রচেষ্টার সীমা (সর্বোচ্চ ৪)
সম্ভাব্য ভুলগুলি:
WRONG_ACTIVATION_ID - অবৈধ আইডি, অ্যাক্টিভেশন বিদ্যমান নেই
ERROR_SQL - SQL-সার্ভার ত্রুটি
BAD_KEY - অবৈধ API কী
BAD_ACTION - ভুল অ্যাকশন
API রেন্ট
প্যারামিটারসমূহ:
$api_key - API কী
$time* - ভাড়ার সময়কাল (ডিফল্ট: ৪ ঘণ্টা)
$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* - ঘণ্টায় ভাড়ার সময়কাল (ডিফল্ট: ৪ ঘণ্টা)। পরবর্তী উপলব্ধ সময়কাল হলো ১২ ঘণ্টা, তারপর ২৪ ঘণ্টা। এক দিন বা তার বেশি সময়ের জন্য ভাড়া চাইলে আপনাকে অবশ্যই পাঠাতে হবে: ২৪, ৪৮, ৭২ ইত্যাদি।
$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 - নম্বর অর্ডার করার সময় রিপ্লাইতে প্রাপ্ত ভাড়া আইডি
$page* - যে পৃষ্ঠা থেকে নির্বাচন শুরু হয় তার সংখ্যা (পৃষ্ঠা নম্বরকরণ ০ থেকে শুরু হয়, নতুন থেকে পুরনো ক্রমে; ডিফল্ট হলো ০)
$size* - পৃষ্ঠার আকার (ডিফল্ট ১০)
* ঐচ্ছিক প্যারামিটার। যদি উল্লেখ না করা হয়, তবে ডিফল্ট প্যারামিটার ব্যবহার করা হবে।
উত্তর:
সার্ভিসের প্রতিক্রিয়া 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" } } }
* শুধুমাত্র এসএমএস থাকলে সফল হবে (বক্স 'quantity' > ০)।
সম্ভাব্য ভুলগুলি:
BAD_KEY - অবৈধ API কী
JSON ফরম্যাটে উত্তর দিন:
{ "status": "error", "message": "*possible_answer*" } ফিল্ডে সম্ভাব্য উত্তরসমূহ "message": NO_ID_RENT - ভাড়া আইডি উল্লেখ করা হয়নি INVALID_PHONE - নম্বরটি আপনার দ্বারা ভাড়া নেওয়া হয়নি (অবৈধ ভাড়া আইডি) STATUS_FINISH - ভাড়া পরিশোধিত এবং সম্পন্ন হয়েছে STATUS_CANCEL - ফেরত সহ ভাড়া বাতিল করা হয়েছে STATUS_WAIT_CODE - প্রথম এসএমএস-এর অপেক্ষায় STATUS_REVOKE - নম্বরটি ব্লক করা হয়েছে, আপনার তহবিল ফেরত দেওয়া হয়েছে
প্যারামিটারসমূহ:
$api_key - API কী
$id - নম্বর অর্ডার করার সময় রিপ্লাইতে প্রাপ্ত ভাড়া আইডি
$status - স্ট্যাটাস পরিবর্তনের কোড (নম্বর)
স্ট্যাটাস হতে পারে:
উত্তর:
সার্ভিসের প্রতিক্রিয়া JSON ফরম্যাটে থাকবে:
{ "status": "success" }
সম্ভাব্য ভুলগুলি:
BAD_KEY - অবৈধ API কী
JSON ফরম্যাটে উত্তর দিন:
{ "status": "error", "message": "*possible_answer*" }
ফিল্ডে সম্ভাব্য উত্তরসমূহ "message":
NO_ID_RENT - ভাড়া আইডি উল্লেখ করা হয়নি
INCORECT_STATUS - অনুপস্থিত বা ভুলভাবে উল্লেখ করা স্ট্যাটাস
CANT_CANCEL - লিজ বাতিল করা সম্ভব নয় (২০ মিনিটের বেশি সময় অতিবাহিত হয়েছে)
INVALID_PHONE - নম্বরটি আপনার দ্বারা ভাড়া নেওয়া হয়নি (অবৈধ ভাড়া আইডি)
ALREADY_FINISH - লিজ ইতিমধ্যেই সম্পন্ন হয়েছে
ALREADY_CANCEL - লিজ ইতিমধ্যেই বাতিল করা হয়েছে
SERVER_ERROR - সার্ভার ত্রুটি
👉মনোযোগ দিন! এই পদ্ধতিটি শুধুমাত্র শেষ ১০টি নম্বর প্রদর্শন করে। যদি আপনার আরও নম্বরের প্রয়োজন হয়, তবে ব্যবহার করুন 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 - আইডি ভাড়া
$rent_time- ভাড়ার সময় (ডিফল্ট: ৪ ঘণ্টা)
উত্তর:
সার্ভিসের প্রতিক্রিয়া JSON ফরম্যাটে থাকবে:
{ "status": "success", "phone": { "id": 1049, "endDate": "2020-01-31T12:01:52", "number": "79959707564"} }
যখন একটি সম্পন্ন ভাড়া বাড়ানো হয়, এটি পুনরায় অর্ডার করা হবে এবং একটি নতুন আইডি প্রদান করা হবে
সম্ভাব্য ভুলগুলি:
BAD_KEY - অবৈধ API কী
BAD_ACTION - ভুল অ্যাকশন
SERVER_ERROR - সার্ভার ত্রুটি
JSON ফরম্যাটে উত্তর দিন:
{ "status": "error", "message": "*possible_answer*", "info": "*details*" }
ফিল্ডে সম্ভাব্য উত্তরসমূহ "message":
NO_ID_RENT - কোনো ভাড়া আইডি নেই
INVALID_TIME - ভুল সময়। ৪ থেকে ১৩৪৪ ঘণ্টা পর্যন্ত সংখ্যা উপলব্ধ
MAX_HOURS_EXCEED - সর্বোচ্চ উপলব্ধ সময় অতিক্রান্ত হয়েছে
সর্বোচ্চ - সর্বোচ্চ উপলব্ধ সময়
INVALID_PHONE - ভুল ভাড়া আইডি
RENT_DIE - নম্বরটির মেয়াদ শেষ হয়ে গেছে বলে ভাড়া বাড়ানো সম্ভব নয়
NO_BALANCE - অপর্যাপ্ত তহবিল
CHANNELS_LIMIT - অ্যাকাউন্ট ব্লক করা হয়েছে
* এই পদ্ধতিটি শুধুমাত্র MTT অপারেটরের সাথে ভাড়ার ক্ষেত্রে প্রযোজ্য।
প্যারামিটারসমূহ:
$api_key - API কী
$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 - কোনো ভাড়া আইডি নেই
INVALID_PHONE - ভুল ভাড়া আইডি
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.
প্যারামিটারসমূহ:
NONE
রিটার্ন টাইপ:
BigDecimal
প্যারামিটারসমূহ:
NONE
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
countryId(Integer) - দেশের শনাক্তকারী।
service(String) - সেবার সংক্ষিপ্ত নাম।
forward*(boolean) - কল ফরওয়ার্ডিং সহ নম্বর চাওয়া হবে কিনা।
অপারেটরসেট*(সেট) - অপারেটরদের সেট।
ফোনএক্সসেপশন*(সেট) - শুধুমাত্র রাশিয়ার জন্য প্রিফিক্স বাদ দিয়ে, ৩ থেকে ৬ সংখ্যার একটি সেট (7918,7900111)।
* ঐচ্ছিক বক্স। যদি কিছু নির্দিষ্ট না করা হয়, তবে প্রোফাইলের সেটিং অনুযায়ী ডিফল্ট পরিমাণ দেওয়া হবে।
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
countryId(Integer) - দেশের শনাক্তকারী।
অপারেটরসেট*(সেট) - যে পরিষেবার জন্য অপারেটররা উপলব্ধ তাদের সেট
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
id(ইন্টিজার) - অ্যাক্টিভেশন আইডেন্টিফায়ার
service(String) - সেবার সংক্ষিপ্ত নাম।
অ্যাক্টিভেশন আইডেন্টিফায়ারের পরিবর্তে, আপনি প্রাপ্ত ক্লাস অবজেক্ট পাঠাতে পারেন SMSActivateActivation মেথড ব্যবহার করার পরে getNumber অথবা ব্যবহারের পরে যেকোনো একটি অ্যাক্টিভেশন getMultiServiceNumber.
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
countryId(Integer) - দেশের শনাক্তকারী।
serviceMap(সেট) - যেসব পরিষেবার অ্যাক্টিভেশন কেনা হয়েছে তার সেট
multiForwardList(লিস্ট) - কল ফরওয়ার্ডিং উপলব্ধ এমন পরিষেবাগুলির তালিকা
operatorSet(সেট) - অপারেটরদের সেট।
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
NONE
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
countryId(Integer) - দেশের শনাক্তকারী।
service(String) - সেবার সংক্ষিপ্ত নাম।
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
countryId(Integer) - দেশের শনাক্তকারী।
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
activationId(ইন্টিজার) - অ্যাক্টিভেশন আইডেন্টিফায়ার
অ্যাক্টিভেশন আইডেন্টিফায়ারের পরিবর্তে, আপনি প্রাপ্ত ক্লাস অবজেক্ট পাঠাতে পারেন SMSActivateActivation মেথড ব্যবহার করার পরে getNumber অথবা ব্যবহারের পরে যেকোনো একটি অ্যাক্টিভেশন getMultiServiceNumber.
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
id(ইন্টিজার) - অ্যাক্টিভেশন আইডেন্টিফায়ার
status(SMSActivateClientStatus) - অ্যাক্টিভেশনের জন্য যে স্ট্যাটাস সেট করতে হবে
অ্যাক্টিভেশন আইডেন্টিফায়ারের পরিবর্তে, আপনি প্রাপ্ত ক্লাস অবজেক্ট পাঠাতে পারেন SMSActivateActivation মেথড ব্যবহার করার পরে getNumber অথবা ব্যবহারের পরে যেকোনো একটি অ্যাক্টিভেশন getMultiServiceNumber.
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
NONE
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
activationId(ইন্টিজার) - অ্যাক্টিভেশন আইডেন্টিফায়ার
অ্যাক্টিভেশন আইডেন্টিফায়ারের পরিবর্তে, আপনি প্রাপ্ত ক্লাস অবজেক্ট পাঠাতে পারেন SMSActivateActivation মেথড ব্যবহার করার পরে getNumber অথবা ব্যবহারের পরে যেকোনো একটি অ্যাক্টিভেশন getMultiServiceNumber.
রিটার্ন টাইপ:
অ্যাক্টিভেশন সহ এসএমএস-এর পূর্ণ টেক্সট পাওয়ার অ্যালগরিদম
getNumber পদ্ধতি ব্যবহার করে একটি নম্বর পাওয়া, তারপর নিম্নলিখিত actions available:
CANCEL - 8 - অ্যাক্টিভেশন বাতিল করুন (যদি নম্বরটি আপনার সাথে মেলে না)
MESSAGE_WAS_SENT - এসএমএস পাঠানো হয়েছে তা জানানোর জন্য (এসএমএস-এর পূর্ণাঙ্গ টেক্সট পেতে এটি বাধ্যতামূলক)
MESSAGE_WAS_SENT স্ট্যাটাস বাধ্যতামূলকভাবে সেট করার পর, অ্যাক্টিভেশন প্যারামিটার এবং এসএমএস-এর জন্য অপেক্ষার সময় সহ waitSMS মেথড ব্যবহার করে এসএমএস গ্রহণের জন্য ভেরিয়েবল সেট করুন।
এসএমএস পাওয়ার পর, আপনি getFullSMS মেথড ব্যবহার করে তা সংগ্রহ করতে পারেন এবং তারপর getText() মেথড ব্যবহার করে পূর্ণাঙ্গ টেক্সট প্রদর্শন করতে পারেন।
এরপর, আপনি অ্যাক্টিভেশনগুলোকে নিম্নলিখিত স্ট্যাটাসে সেট করতে পারেন:
MESSAGE_WAS_SENT স্ট্যাটাস সহ অ্যাক্টিভেট করতে:
CANCEL - অ্যাক্টিভেশন বাতিল করুন
কোড পাওয়ার অব্যবহিত পরে:
REQUEST_ONE_MORE_CODE - আরেকটি এসএমএস অনুরোধ করুন
FINISH - এসএমএস কোড নিশ্চিত করুন এবং অ্যাক্টিভেশন সম্পন্ন করুন
REQUEST_ONE_MORE_CODE স্ট্যাটাস সহ অ্যাক্টিভেট করতে:
FINISH - এসএমএস কোড নিশ্চিত করুন এবং অ্যাক্টিভেশন সম্পন্ন করুন
প্যারামিটারসমূহ:
countryId(Integer) - দেশের শনাক্তকারী।
service(String) - সেবার সংক্ষিপ্ত নাম।
hours(পূর্ণসংখ্যা)* - ভাড়ার সময়কাল
operator(স্ট্রিং)* - মোবাইল অপারেটরের নাম
urlWebhook(স্ট্রিং)* - ওয়েবহুকের লিংক (ডিফল্টভাবে বিবেচনা করা হয় না)
ওয়েবহুক কী?* ঐচ্ছিক প্যারামিটার। উল্লেখ না করা হলে, ডিফল্ট হবে
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
countryId(Integer) - দেশের শনাক্তকারী।
operatorSet(সেট) - মোবাইল অপারেটরগুলোর সেট
hours(পূর্ণসংখ্যা)* - ভাড়ার সময়কাল
* ঐচ্ছিক প্যারামিটার। উল্লেখ না করা হলে, ডিফল্ট হবে
রিটার্ন টাইপ:
প্যারামিটারসমূহ:
rentId(পূর্ণসংখ্যা) - ভাড়া নেওয়া নম্বরের শনাক্তকারী
rentId-এর পরিবর্তে, আপনি প্রাপ্ত ক্লাস অবজেক্ট পাস করতে পারেন SMSActivateRentActivation মেথড ব্যবহার করার পরে getRentNumber
রিটার্ন টাইপ:
ইমেইল 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- সাজানোর দিক। (desc, asc)
উত্তর:
সার্ভিসের প্রতিক্রিয়া 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 - আপনি প্রথম ২ মিনিটের মধ্যে মেইল বাতিল করতে পারবেন না।
প্যারামিটারসমূহ:
$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.study 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





















































