MultiTEL APIv3

MultiTEL API کے بارے میں:

یہ API ان ڈویلپرز کے لیے ہے جو ہمارے وائس پلیٹ فارم سے اپنے نظام کو جوڑنا یا اس پلیٹ فارم کی بنیاد پر نئے نظام بنانا چاہتے ہیں۔

ہمارے APIs URI پاتھز کے ذریعے وسائل (ڈیٹا اینٹیٹیز) تک رسائی فراہم کرتے ہیں۔ REST API استعمال کرنے کے لیے، آپ کی ایپلیکیشن
HTTP درخواست بھیجے گی اور جواب کو پارس کرے گی۔ بطور ڈیفالٹ، جواب کی شکل JSON ہے۔

آپ کے طریقے معیاری HTTP طریقے GET اور POST ہوں گے۔ چونکہ API کھلے معیارات پر مبنی ہے،
آپ API تک رسائی کے لیے کوئی بھی ویب ڈویلپمنٹ زبان استعمال کر سکتے ہیں۔

استعمال شدہ اینڈ پوائنٹ:

https://api.multitel.net/v3

تصدیق:​

MultiTEL APIv3، HTTP Basic/Digest تصدیق استعمال کرتا ہے۔ اس سے آپ اپنے ویب سرور کے URL محفوظ کر سکتے ہیں تاکہ صرف آپ اور MultiTEL
ان تک رسائی پا سکیں۔ HTTP تصدیق کے لیے اس URL فارمیٹ میں صارف نام اور پاس ورڈ دے سکتے ہیں:

https://USERNAME:PASSWORD@api.multitel.net/v3/getcountries 

HTTP Basic تصدیق کے لیے آپ اپنا MultiTEL اکاؤنٹ یوزر نیم اور پاس ورڈ استعمال کریں گے۔
متبادل طور پر، آپ یہاں مخصوص API یوزرز بنا سکتے ہیں: https://multitel.net/settings.

curl -G https://api.multitel.net/v3/getcountries \
    -u '[YOUR USERNAME]:[YOUR PASSWORD]'

آؤٹ پٹ:

تمام API فنکشنز status اور response سیکشنز واپس کریں گے۔ اسٹیٹس ایک عددی کوڈ ہوگا جو HTTP اسٹیٹس کوڈز پر مبنی ہے۔

اسٹیٹس کوڈ 200 والی ہر چیز کو کامیابی سمجھا جائے گا۔
4xx رینج کے اندر اسٹیٹس کوڈ والی ہر چیز کو کلائنٹ کی خرابی سمجھا جائے گا (ممنوعہ کوڈز، ناکافی بیلنس کے کوڈز وغیرہ)۔
5xx رینج کے اندر اسٹیٹس کوڈ والی ہر چیز کو سرور کی خرابی سمجھا جائے گا۔

نمونہ آؤٹ پٹ، نیچے:

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "33554530000",
    "price": {
      "per_minute": "0.006",
      "free_minutes": "0",
      "setup_price": "0",
      "monthly_price": "0.7",
      "channels": "0",
      "overflow": "1"
    }
  }
}

RentNumber کی حوالہ جاتی دستاویز سے جواب کی مثال؛ مثال میں دی گئی رقوم قیمت کی موجودہ پیشکش نہیں ہیں۔