بھیجے جانے والے فیکس کے کاموں کی فہرست دیکھیں

بھیجے جانے والے فیکس کے کاموں کی فہرست دیکھیں

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

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode search=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_outbox

درخواست سنبھالنے والا یہ جزو date_from یا date_to فلٹرز کی حمایت نہیں کرتا۔ پورٹل کے آؤٹ باکس میں اضافی فلٹرز موجود ہیں جنہیں اس API درخواست میں نقل نہیں کرنا چاہیے۔ نتائج تخلیق کے وقت کے مطابق، نئے سے پرانے کی ترتیب میں آتے ہیں؛ شناختی نمبر کے مطابق کوئی ثانوی ترتیب یا ڈیٹا کی ایک مقررہ حالت کا کرسر موجود نہیں ہے۔

کاموں کے ریکارڈ پڑھیں

HTTP کا نتیجہ اور JSON میں status.code، دونوں پڑھیں۔ کامیاب جواب میں response.faxes اور response.pagination شامل ہوتے ہیں؛ مثال میں فرضی ڈیٹا استعمال کیا گیا ہے۔ خالی میل باکس کی صورت میں faxes کی خالی صف واپس ملتی ہے، جس میں total کی قدر 0 اور total_pages کی قدر 0 ہوتی ہے۔

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 13,
      "uuid": "0123456789abcdef0123456789abcdef",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "status": "queued",
      "pages_requested": 3,
      "pages_sent": 0,
      "cost": "0.07500",
      "result_text": "",
      "created_at": "2026-10-01 12:00:00",
      "sent_at": null,
      "updated_at": "2026-10-01 12:00:00"
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id ریکارڈ کا عددی شناختی نمبر ہے۔ uuid کام کا نظر آنے والا شناختی نشان ہے؛ نئی درخواستیں جمع کراتے وقت send_fax سے واپس ملنے والا کام کا شناختی نمبر استعمال کریں اور اسے محفوظ رکھیں تاکہ اس کے ذریعے حالت کی وقفے وقفے سے جانچ کی جا سکے۔ فہرست میں پرانے ریکارڈ بھی شامل ہو سکتے ہیں، اس لیے یہ فرض نہ کریں کہ ہر قطار درخواست جمع کرانے والے اسی اینڈ پوائنٹ کے ذریعے بنائی گئی تھی۔

status اور result_text میں کارروائی کی ریکارڈ شدہ حالت اور پیغام موجود ہوتے ہیں۔ یہ فہرست انہیں ترسیل کی حالتوں کے کسی مکمل، یکساں مقررہ مجموعے میں تبدیل نہیں کرتی۔ قطار میں ہونے کا مطلب انتظار کی قطار میں ہونا ہے، وصول کنندہ تک پہنچ جانا نہیں۔ اہم دستاویزات کے لیے، فیکس کو پہنچا ہوا سمجھنے یا نقل دوبارہ جمع کرانے سے پہلے وصول کنندہ سے وصولی کی تصدیق کریں۔

pages_requested اور pages_sent عددی شمار ہیں۔ cost محفوظ شدہ قدر کو برقرار رکھتا ہے، اور متبادل کے طور پر 0.00 کی متنی قدر استعمال کرتا ہے؛ یہ فرض نہ کریں کہ اس کی JSON ڈیٹا قسم ان باکس کی لاگت جیسی ہے۔ قطار میں موجود ریکارڈ میں پہلے سے تخمینہ شامل ہو سکتا ہے۔ نہ یہ قدر اور نہ ہی فہرست میں ریکارڈ کی موجودگی حتمی بلنگ طے کرتی ہے۔

created_at, sent_at اور updated_at سرور کے وضع کردہ فارمیٹ میں محفوظ قدریں ہیں جن میں ٹائم زون کا فرق شامل نہیں ہوتا؛ sent_at کی قدر null ہو سکتی ہے۔ حالت معلوم کرنے کے الگ اینڈ پوائنٹ سے واپس ملنے والا ویب ہُک کی حالت کا خانہ اس فہرست میں شامل نہیں ہوتا۔

صفحات کی معلومات احتیاط سے یکجا کریں

pagination.page، limit، total اور total_pages کے مطابق صفحات دیکھیں۔ آخری صفحے کے بعد کے صفحات خالی ہو سکتے ہیں۔ آپ کے صفحات دیکھنے کے دوران نئے کاموں کی وجہ سے اندراجات ایک صفحے سے دوسرے پر منتقل ہو سکتے ہیں۔ صفحات کی معلومات یکجا کرتے وقت کاموں کے شناختی نشانات محفوظ رکھیں؛ یہ اینڈ پوائنٹ ڈیٹا کی ایک ہی مستقل حالت برقرار رہنے کی ضمانت نہیں دیتا۔

رازداری اور دوبارہ کوششیں

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