বহির্গামী ফ্যাক্সের নথি ডাউনলোড করুন

নথির জন্য অনুরোধ করুন

একটি সক্রিয় 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

fax_status-এ ব্যবহৃত একই আবশ্যক 32 অক্ষরের হেক্সাডেসিমাল job_id ব্যবহার করুন। গ্রাহকের এই অনুরোধ কেবল প্রমাণীকৃত মালিকই করতে পারেন। এই উদাহরণে উত্তরের হেডার ও বাইট আলাদাভাবে সংরক্ষণ করা হয়, যাতে API ত্রুটিকে ভুল করে PDF বলে ধরে নেওয়া না হয়।

ফাইল বা JSON ত্রুটি সামলান

সফল হলে নথির কাঁচা বাইটের সঙ্গে Content-Type এবং Content-Disposition সংযুক্তি হেডার ফেরত আসে, JSON আবরণ নয়। সংরক্ষিত ফাইলের নাম দেওয়া, সেটি খোলা বা প্রক্রিয়া করার আগে ওই হেডারগুলো পরীক্ষা করুন। কোন নথি উপলব্ধ আছে তার ওপর নির্ভর করে উত্তরটি PDF, TIFF অথবা আপলোড করা মূল বিন্যাসে হতে পারে। সারিতে থাকা কোনো কাজ রূপান্তরের আগেই তার মূল উৎস ফাইল ফেরত দিতে পারে।

ব্যর্থ হলে স্বাভাবিক JSON status/response আবরণ ফেরত আসে। API কোড 400 মানে job_id অনুপস্থিত বা ভুল গঠনের; 401 মানে প্রমাণীকরণ অনুপস্থিত; 404 মানে কাজটি বা তার ফাইল এই অ্যাকাউন্টের জন্য উপলব্ধ নয়। HTTP স্ট্যাটাস 200 হলেও Content-Type এবং status.code পরীক্ষা করুন।

প্রাপ্যতা ও গোপনীয়তা

কোনো কাজের রেকর্ড থাকলেই তার ফাইল চিরকাল ডাউনলোড করা যাবে, এমন নিশ্চয়তা নেই; সংরক্ষণের মেয়াদ যাচাই করা হয়নি। প্রয়োজনে যেসব নথি সংরক্ষণের অনুমতি আপনার আছে, সেগুলো আপনার নিজের নিয়ন্ত্রণাধীন সংরক্ষণস্থলে রাখুন। ফেরত পাওয়া ফাইলে প্রাপকের ব্যক্তিগত তথ্য থাকতে পারে। ডাউনলোড করলে নতুন কোনো ফ্যাক্স পাঠানো হয় না।