بھیجے جانے والے فیکس کی دستاویز ڈاؤن لوڈ کریں

دستاویز کی درخواست کریں

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

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  --dump-header fax-response.headers --output fax-response.bin \
  https://api.multitel.net/v3/fax_download

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

فائل یا JSON کی خرابی کو سنبھالیں

کامیابی کی صورت میں دستاویز کے خام بائٹس، منسلک فائل کے Content-Type اور Content-Disposition ہیڈرز کے ساتھ واپس ملتے ہیں، JSON کے لفافے میں نہیں۔ محفوظ شدہ فائل کو نام دینے، کھولنے یا اس پر کارروائی کرنے سے پہلے ان ہیڈرز کو چیک کریں۔ دستیاب دستاویز کے لحاظ سے جواب PDF، TIFF یا اپ لوڈ کیے گئے اصل فارمیٹ میں ہو سکتا ہے۔ قطار میں موجود کام، فارمیٹ کی تبدیلی سے پہلے اپنی اصل ماخذ فائل واپس کر سکتا ہے۔

ناکامی کی صورت میں معمول کا JSON status/response لفافہ واپس ملتا ہے۔ API کا کوڈ 400 بتاتا ہے کہ job_id موجود نہیں یا اس کی ساخت درست نہیں؛ 401 کا مطلب ہے کہ شناخت کی تصدیق موجود نہیں؛ 404 کا مطلب ہے کہ کام یا اس کی فائل اس اکاؤنٹ کے لیے دستیاب نہیں۔ Content-Type اور status.code کو تب بھی چیک کریں جب HTTP کا اسٹیٹس 200 ہو۔

دستیابی اور رازداری

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