REST API دستاویزات
فون نمبر REST APIs
دستیاب ممالک اور نمبر تلاش کریں، مکمل پیشکش کا جائزہ لیں اور اپنے ملکیتی نمبروں کا انتظام کریں۔
API اور اسناد کا انتخاب ایک ساتھ کریں
ڈیولپر اور آٹومیشن، کاروبار اور کمیونیکیشنز فراہم کنندگان کے منظور شدہ اکاؤنٹس فعال سروسز کو انٹیگریٹ کر سکتے ہیں۔ انفرادی ڈیولپر کو خود کو کمپنی ظاہر کرنے کی ضرورت نہیں۔ ایپلیکیشن SMS/MMS کے لیے متعلقہ بھیجنے کی منظوری اور رجسٹریشن درکار ہے۔ افراد اور خاندان کی سروس میں صارفین کے لیے پیغامات بھیجنے کا عمل شروع کرنے والا کوئی API موجود نہیں۔
| API فیملی | بنیادی URL | تصدیق اور نتیجہ |
|---|---|---|
| Communications v3 | https://api.multitel.net/v3 | منظور شدہ Basic اسناد؛ اہل اور فراہم کردہ ٹوکن صرف ان آپریشنز کے لیے جو انہیں سپورٹ کرتے ہوں۔ JSON status اور response۔ |
| ہنگامی کالنگ کے لیے رجسٹریشن | https://api.multi.tel/emergency | منظور شدہ Basic اسناد یا خاص طور پر فراہم کی گئی bearer رسائی۔ JSON code، message اور data۔ |
| پورٹل REST انٹیگریشنز | ہوسٹ اور آپریشن، جیسا کہ آپ کے اکاؤنٹ کے ڈویلپر ریفرنس میں دکھایا گیا ہے | اس آپریشن کی دستاویزات میں درج اسناد، اجازت کے دائرے اور اسکیما استعمال کریں۔ براؤزر سیشن کی درخواستیں ایک الگ انٹرفیس استعمال کرتی ہیں۔ |
مثالیں استعمال کرنے سے پہلے MULTITEL_API_USERNAME اور MULTITEL_API_PASSWORD کو اپنے سرور کی خفیہ کنفیگریشن کے ذریعے سیٹ کریں۔ انہیں کبھی بھی عوامی براؤزر JavaScript، URLs یا سورس کنٹرول میں شامل نہ کریں۔ مخصوص اسناد کا انتظام API انضمام کی سیٹنگز میں کیا جاتا ہے۔
دستیاب ممالک کا کیٹلاگ پڑھیں
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/getcountries"v3 جواب میں status اور response کی ایک array شامل ہوتی ہے۔ ملک کی اندراجات میں isocode، name، countrycode، صلاحیتوں کی معلومات اور next_function شامل ہوتے ہیں۔ دستیابی اکاؤنٹ اور انوینٹری پر منحصر ہے؛ کسی ملک کا درج ہونا اس بات کا وعدہ نہیں کہ ہر prefix یا نمبر کی قسم اسٹاک میں ہے۔
{
"status": {
"code": 200,
"msg": "Results: 1"
},
"response": [
{
"countrycode": "1",
"name": "United States",
"description": "United States",
"isocode": "US",
"is_mobile": 0,
"sms_coverage": 1,
"latitude": "37.0902",
"longitude": "-95.7129",
"next_function": "v3/getareas/US"
}
]
}دریافت سے ایکٹیویشن تک
- متعلقہ جغرافیائی آپریشنز کے ذریعے ملک، جہاں ضروری ہو وہاں ذیلی تقسیم، علاقہ اور نمبر کی قسم منتخب کریں۔
- منتخب نمبر کی سیٹ اپ، ماہانہ اور استعمال کی قیمتیں، کال چینلز، شامل استعمال کی حد اور رجسٹریشن کی شرائط پڑھیں۔
- مطلوبہ اینڈ یوزر دستاویزات جمع کرائیں اور ان کی حالت کا جائزہ لیں۔ منظوری تک نمبر زیرِ التوا رہ سکتا ہے۔
- انوینٹری اور قیمت کے درست انتخاب کے ساتھ ایک ہی بار آرڈر کریں۔ اگر جواب غیر یقینی ہو تو دوسرا آرڈر جمع کرانے سے پہلے اپنی انوینٹری دیکھیں۔
- وائس روٹنگ اور میسجنگ ڈیلیوری کو الگ الگ کنفیگر کریں، پھر مطلوبہ مکمل راستے کی جانچ کریں۔
غلطیوں اور دوبارہ کوششوں کو سنبھالیں
- تصدیق یا اجازت کی ناکامی
- API اسناد کی فعال حالت، اجازت یافتہ سروس اور سورس IP کی پابندی چیک کریں۔ پورٹل سیشن کوکی انضمام کی اسناد نہیں ہے۔
- ناکافی کریڈٹ یا نامکمل منظوری
- آپریشن دوبارہ کرنے سے پہلے اکاؤنٹ بیلنس، بھیجنے کی منظوری یا دستاویز کی شرط کو پورا کریں۔
- کوئی نتیجہ نہیں
- خالی انوینٹری یا کالر کے نام کی عدم موجودگی کو ایک عام نتیجہ سمجھ کر سنبھالیں۔ یہ فرض نہ کریں کہ نحوی طور پر درست نمبر پر ہر سروس دستیاب ہے۔
- نیٹ ورک ٹائم آؤٹ یا سروس کی ناکامی
- پڑھنے (read) کے آپریشنز کے لیے backoff کے ساتھ محدود دوبارہ کوششیں استعمال کریں۔ خریداری، بھیجنے یا رجسٹریشن کے لیے پہلے آپریشن کی حالت دیکھیں؛ قبول شدہ درخواست کو دوبارہ بھیجنے سے قابلِ بل عمل دہرایا جا سکتا ہے۔
Idempotency کی سہولت ہر API فیملی کی اپنی ہوتی ہے۔ Emergency API دوبارہ کوشش کی کلیدیں (retry keys) سپورٹ کرتی ہے؛ اس کا مطلب یہ نہیں کہ کوئی بھی v3 درخواست idempotent ہے۔ سپورٹ کے لیے ٹائم اسٹیمپ، واپس آنے والی IDs اور حساس معلومات ہٹائے ہوئے جوابات محفوظ رکھیں۔
اپنے اکاؤنٹ کے ریفرنس کے ساتھ آگے بڑھیں
سائن اِن ریفرنس آپریشنز کو آپ کی اجازتوں اور فعال سروسز کے مطابق فلٹر کرتا ہے۔ اس کا درست ہوسٹ، اسناد کی قسم، درخواست کے فیلڈز اور رسپانس اسکیما استعمال کریں۔ کنسولز لائیو آپریشنز چلا سکتے ہیں، جن میں خریداریاں اور پیغامات بھی شامل ہیں۔