فیکس کے کام کی حالت دیکھیں

اپنا کام تلاش کریں

فعال MultiTEL API اکاؤنٹ استعمال کریں۔ پاس ورڈ والے اکاؤنٹ کے لیے HTTP Basic اسناد، یا ٹوکن والے اکاؤنٹ کے لیے Bearer ٹوکن بھیجیں۔ اکاؤنٹ کی اجازتیں اور IP پابندیاں اب بھی لاگو ہیں۔ ورکر کی اندرونی اسناد استعمال نہ کریں۔

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_status

job_id لازمی ہے اور اسے send_fax کا لوٹایا ہوا 32 حروف کا ہیکساڈیسیمل شناخت کنندہ ہونا چاہیے۔ اسے بالکل درست نقل کریں۔ درخواستیں تصدیق شدہ مالک تک محدود ہیں۔

نتیجہ پڑھیں

HTTP نتیجہ اور JSON کا status.code فیلڈ دونوں پڑھیں۔ JSON کی ناکامیاں HTTP 200 کے ساتھ آ سکتی ہیں۔ کامیاب JSON جواب میں status اور response ہوتے ہیں؛ مثالوں میں فرضی ڈیٹا ہے۔

{
  "status": {
    "code": 200,
    "msg": "Fax status"
  },
  "response": {
    "job_id": "0123456789abcdef0123456789abcdef",
    "from_number": "+12125550123",
    "to_number": "+12125550124",
    "status": "queued",
    "result": "",
    "pages_requested": 3,
    "pages_sent": 0,
    "cost": "0.07500",
    "webhook_status": "",
    "created_at": "2026-10-23 10:00:00",
    "updated_at": "2026-10-23 10:00:00"
  }
}

مثال قطار میں موجود کام کی ہے، پہنچائے گئے فیکس یا قیمت کی پیشکش کی نہیں۔ pages_requested ماخذ کے شناخت شدہ صفحات کی تعداد ہے؛ pages_sent پروسیسنگ کے دوران ریکارڈ کردہ پیش رفت بتاتا ہے۔ cost اعشاری عدد والی اسٹرنگ ہے اور قطار میں رہتے ہوئے بھی تخمینہ رکھ سکتی ہے۔ result پروسیسنگ کی تفصیل رکھتا ہے؛ webhook_status کال بیک کی ریکارڈ کردہ حالت رکھتا ہے۔ ٹائم اسٹیمپس سرور کے وضع کردہ اسٹرنگز ہیں جن میں ٹائم زون کا فرق نہیں ہے۔

تیز مسلسل لوپ کے بجائے بڑھتے ہوئے وقفوں سے حالت پوچھیں۔ پروسیسنگ بھیجی گئی یا مکمل حالت بتا سکتی ہے، مگر موجودہ جائزے نے وصول کنندہ تک پہنچنے کی ضمانت ثابت نہیں کی۔ اہم دستاویز کے لیے اسے پہنچا ہوا سمجھنے یا دوبارہ بھیجنے سے پہلے وصول کنندہ سے وصولی کی تصدیق کریں۔ فعال ورکر کا دورانیۂ عمل، حتمی بلنگ اصول اور کال بیک کا معاہدہ ابھی زیرِ جانچ ہیں۔ یہ نہ سمجھیں کہ قطار میں قبولیت یا کام کا غیرخالی ID پہنچ جانے کو ظاہر کرتا ہے۔

خرابیاں

API کوڈ 400 کا مطلب job_id غائب یا غلط ساخت میں ہے؛ 401 کا مطلب توثیق غائب ہے؛ 404 کا مطلب اس اکاؤنٹ کے لیے کام نہیں ملا۔ صرف شناخت کنندہ سے ملکیت اخذ نہ کریں۔