ইনবক্স বা আউটবক্সের ফ্যাক্স ডাউনলোড করুন

প্রাপ্ত বা বহির্গামী নথি বেছে নিন

সামঞ্জস্য বজায় রাখার এই এন্ডপয়েন্ট আপনার অ্যাকাউন্টের একটি ফ্যাক্স নথি সংগ্রহ করে। নির্ধারিত পরিচয়প্রমাণ ও আইপি বিধিনিষেধ মেনে সক্রিয় MultiTEL API অ্যাকাউন্ট দিয়ে HTTPS ব্যবহার করুন। এটি ফ্যাক্স পাঠায় না বা পুনরায় পাঠায় না।

ডাউনলোড পাথের প্যারামিটার
প্যারামিটার	আবশ্যক	অর্থ
`type`	হ্যাঁ	যেভাবে দেখানো হয়েছে ঠিক সেভাবেই inbound অথবা outbound ব্যবহার করুন।
`id`	হ্যাঁ	inbound-এর জন্য fax_inbox থেকে ফেরত পাওয়া hash ব্যবহার করুন। outbound-এর জন্য fax_outbox থেকে ফেরত পাওয়া uuid ব্যবহার করুন।

এই মানগুলো পাথে দিতে হবে। রুট হলো /v3/fax_file/{type}/{id}, অতিরিক্ত পাথ অংশসহ fax_download নয়। প্রাপ্ত ফ্যাক্সের হ্যাশ সংখ্যাসূচক রেকর্ড আইডি নয় এবং বহির্গামী কাজের আইডিও নয়। উপযুক্ত মেইলবক্সের তালিকা থেকে শনাক্তকারীটি কপি করুন; এটি প্রমাণীকরণের বিকল্প নয়।

প্রাপ্ত ফ্যাক্স ডাউনলোড করুন

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --dump-header fax-response.headers --output fax-response.bin \
  https://api.multitel.net/v3/fax_file/inbound/c20ad4d76fe97759aa27a0c99bff6710

উদাহরণের হ্যাশটি কাল্পনিক ইনবক্স রেকর্ড 12 বোঝায়। আপনার নিজস্ব মান সংগ্রহের উৎস: fax_inbox। বিদ্যমান প্রাপ্ত ফ্যাক্সের রেকর্ড ডাউনলোড করলে সেটি দেখা হয়েছে বলে চিহ্নিত হয়। ফাইল পাওয়া যাচ্ছে কি না তা যাচাই করার আগেই এটি ঘটে, তাই ফাইল পাওয়া যাচ্ছে না এমন ত্রুটি হলেও viewed-এর মান true থেকে যেতে পারে। প্রাপ্ত ফ্যাক্সের দেখা-হওয়ার অবস্থা অপরিবর্তিত রাখতে চাইলে শুধু ফ্যাক্সটি আছে কি না যাচাই করার জন্য এই এন্ডপয়েন্ট ব্যবহার করবেন না।

হ্যান্ডলার সংরক্ষিত PDF-কে অগ্রাধিকার দেয়। তা না থাকলে সংরক্ষিত TIFF ব্যবহার করে এবং রূপান্তরকারী উপলব্ধ থাকলে PDF-এ রূপান্তরের চেষ্টা করে। রূপান্তরের সুবিধা না থাকলে অথবা রূপান্তরের সময় হ্যান্ডলার সামলাতে পারে এমন ব্যতিক্রম ঘটলে পরিবর্তে TIFF ফেরত দেয়। PDF ধরে না নিয়ে সবসময় ফেরত পাওয়া Content-Type পরীক্ষা করুন।

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

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --dump-header fax-response.headers --output fax-response.bin \
  https://api.multitel.net/v3/fax_file/outbound/0123456789abcdef0123456789abcdef

uuid ব্যবহার করুন; এটি সংগ্রহের উৎস: fax_outbox। সামঞ্জস্য বজায় রাখার এই ডাউনলোড প্রথমে সংরক্ষিত PDF ব্লব, তারপর TIFF ব্লব, তারপর উপলব্ধ PDF ফাইল, TIFF ফাইল অথবা মূল উৎস ফাইলকে অগ্রাধিকার দেয়। এর অগ্রাধিকারের ক্রম আলাদা; তুলনায় বর্তমান বহির্গামী ডাউনলোডের হ্যান্ডলার হলো fax_download। নতুন সংযোগের ক্ষেত্রে যদি ব্যবহার করেন send_fax, তাহলে সেটির job_id প্যারামিটারসহ ওই বর্তমান ডাউনলোড কার্যপ্রবাহ ব্যবহার করুন।

মূল উৎস ফাইল PDF বা TIFF-এর পরিবর্তে application/octet-stream হিসেবে ফেরত আসতে পারে। সংযুক্ত ফাইলের নামে উৎসের এক্সটেনশন থেকে যেতে পারে। সামঞ্জস্য বজায় রাখার এই বহির্গামী ডাউনলোড ইনবক্সের রেকর্ডকে দেখা হয়েছে বলে চিহ্নিত করে না, কাজের অবস্থা বদলায় না এবং কোনো ফ্যাক্স প্রেরণও শুরু করে না।

বাইট ও ত্রুটি আলাদাভাবে সামলান

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

API কোড 400 বোঝায় পাথের কোনো আবশ্যক মান অনুপস্থিত অথবা type অবৈধ। API কোড 404 বোঝায় অ্যাকাউন্টের আওতাধীন রেকর্ড বা সেটির ফাইল পাওয়া যাচ্ছে না। ত্রুটির ক্ষেত্রে স্বাভাবিক JSON status/response মোড়ক ব্যবহৃত হয় এবং HTTP 200-ও ব্যবহৃত হতে পারে। প্রতিক্রিয়ার Content-Type এবং JSON-এর status.code পরীক্ষা করুন, যাতে ত্রুটির বিষয়বস্তু নথি হিসেবে খোলা না হয়।

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

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