موصولہ فیکسوں کی فہرست دیکھیں

موصولہ فیکسوں کی فہرست دیکھیں

MultiTEL کا فعال API اکاؤنٹ HTTPS کے ذریعے استعمال کریں، اور اس کے لیے مقرر کردہ اسناد اور نیٹ ورک پتوں کی پابندیوں کی پیروی کریں۔ یہ اینڈ پوائنٹ ان موصولہ فیکسوں کی فہرست دیتا ہے جو شناخت کی توثیق شدہ اکاؤنٹ سے تعلق رکھتے ہیں۔ یہ نہ فیکس بھیجتا ہے اور نہ اس کی دستاویز ڈاؤن لوڈ کرتا ہے۔

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode date_from=2026-10-01 \
  --data-urlencode date_to=2026-10-02 \
  https://api.multitel.net/v3/fax_inbox

تاریخ کی دونوں حدیں شامل ہوتی ہیں اور API سرور کی تاریخ کی تعبیر استعمال ہوتی ہے، صارف کے درخواست کردہ ٹائم زون کی نہیں۔ غلط تاریخ کی متنی قدریں مسترد ہونے کے بجائے نظر انداز بھی کی جا سکتی ہیں؛ بھیجنے سے پہلے ان کی درستی جانچیں۔ تاریخ کے فلٹرز نہ ہوں تو درخواست کو سنبھالنے والا عمل کوئی طے شدہ زمانی حد لاگو نہیں کرتا۔ نتائج موصول ہونے کے وقت کے لحاظ سے ترتیب دیے جاتے ہیں، تازہ ترین پہلے آتے ہیں۔ یہ اینڈ پوائنٹ مختلف صفحات کے لیے ایک مستقل وقتی عکس فراہم نہیں کرتا: نئے فیکس آنے سے ریکارڈز ایک صفحے سے دوسرے پر منتقل ہو سکتے ہیں۔

میل باکس کا صفحہ پڑھیں

HTTP کا نتیجہ اور JSON میں status.code پڑھیں۔ API کے دوسرے حصوں میں ناکامیوں کے لیے JSON کی خطا والی ساخت استعمال ہو سکتی ہے، چاہے HTTP کا اسٹیٹس 200 ہو۔ کامیاب جواب میں response.faxes اور response.pagination شامل ہوتے ہیں۔ اس مثال میں فرضی قدریں استعمال کی گئی ہیں۔

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 12,
      "hash": "c20ad4d76fe97759aa27a0c99bff6710",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "remote_station_id": "Example sender",
      "pages": 2,
      "cost": 0.05,
      "received_at": "2026-10-01 12:00:00",
      "received_timestamp": 1790856000,
      "status": "success",
      "status_text": "OK",
      "emailed": "yes",
      "viewed": false
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id ان باکس کے ریکارڈ کا عددی شناخت کنندہ ہے۔ hash آنے والی دستاویزات کے پرانے طریقۂ کار کے لیے اس کی MD5 نمائندگی ہے؛ یہ نہ send_fax کے کام کا شناخت کنندہ ہے اور نہ اجازت کی سند۔ اسے باہر بھیجے جانے والے فیکسوں کے fax_status اینڈ پوائنٹ کے ساتھ استعمال نہ کریں۔

received_timestamp یونکس کی محفوظ کردہ زمانی مہر ہے۔ received_at سرور کی وضع کردہ زمانی مہر ہے جس میں ٹائم زون کا فرق شامل نہیں ہوتا، یا وصولی کا وقت درج نہ ہونے پر خالی قدر null ہوتی ہے؛ اپنے ٹائم زون میں اوقات دکھاتے وقت یونکس کی قدر استعمال کریں۔ cost JSON کا عدد ہے، قیمت کی پیشکش یا کسی الگ مکمل شدہ چارج کا ثبوت نہیں۔

status صرف اس وقت success ہوتا ہے جب محفوظ کردہ اسٹیٹس کوڈ صفر ہو؛ دوسری قدریں failed بن جاتی ہیں۔ status_text محفوظ کردہ کارروائی کا پیغام رکھتا ہے، اور اس کی عدم موجودگی میں OK یا Failed استعمال ہوتا ہے۔ emailed بولین قدر کے بجائے محفوظ کردہ قدر کو برقرار رکھتا ہے۔ viewed بولین قدر ہے۔ صرف فیکس کے اسٹیٹس سے یہ نتیجہ نہ نکالیں کہ ای میل کامیابی سے پہنچ گئی ہے۔

خالی اور بدلتی ہوئی فہرستوں کو سنبھالیں

خالی میل باکس جواب میں faxes کی خالی صف، total کی قدر 0 اور total_pages کی قدر 0 دیتا ہے۔ آخری صفحے سے آگے کے صفحے کی درخواست پر بھی خالی صف مل سکتی ہے۔ کم از کم ایک صفحہ ہونے کا فرض کرنے کے بجائے صفحات کی تقسیم کے فیلڈز کے مطابق رکیں۔ صفحات میں آگے بڑھنے کا کوئی کرسر یا ریکارڈ کے شناخت کنندے کے لحاظ سے ثانوی ترتیب دستیاب نہیں ہے۔ باہم متداخل صفحات کے ریکارڈز ملاتے وقت ریکارڈز کے شناخت کنندے محفوظ رکھیں۔

دستاویزات تک رسائی اور رازداری

میل باکس کے اندراجات میں ٹیلی فون اور دستاویزات کے نجی میٹا ڈیٹا شامل ہوتے ہیں۔ اپنی ایپلیکیشن میں رسائی محدود رکھیں اور مکمل جوابات کو لاگ میں درج کرنے سے گریز کریں۔ فہرست حاصل کرنے سے دستاویز کو دیکھی گئی قرار نہیں دیا جاتا۔ fax_file کو مطابقت برقرار رکھنے والے طریقے سے آنے والی دستاویز ڈاؤن لوڈ کرنے کے لیے استعمال کریں، اور یاد رکھیں کہ یہ موجودہ آنے والے ریکارڈ کو دیکھی گئی حالت میں نشان زد کرتا ہے، چاہے اس کی فائل دستیاب نہ ہو۔ دستاویزات تک رسائی کے لیے پورٹل کا ان باکس بھی دستیاب ہے۔ فائلوں کو محفوظ رکھنے کی کوئی ضمانت مقرر نہیں کی گئی۔