পাঠানোর আগে
প্রেরকের নম্বর হিসেবে এমন একটি নম্বর ব্যবহার করুন যা প্রদর্শনের অনুমতি আপনার আছে, এবং এমন প্রাপককে ফ্যাক্স পাঠান যিনি আপনার ফ্যাক্সের প্রত্যাশা করছেন। এই অনুরোধ একটি প্রকৃত প্রেরণ তৈরি করে, যার জন্য চার্জ প্রযোজ্য হতে পারে। পৃষ্ঠা শনাক্তকরণের ফল যতটা সম্ভব পূর্বানুমানযোগ্য রাখতে আগে থেকে প্রস্তুত করা PDF বা TIFF ব্যবহার করুন। সারিতে যোগ হওয়ার প্রতিক্রিয়া অনুরোধ গৃহীত হওয়া নিশ্চিত করে, পৌঁছে যাওয়া নয়।
একটি সক্রিয় MultiTEL API অ্যাকাউন্ট ব্যবহার করুন। পাসওয়ার্ডভিত্তিক অ্যাকাউন্টের জন্য HTTP Basic পরিচয়প্রমাণ পাঠান, অথবা টোকেনভিত্তিক অ্যাকাউন্টের জন্য একটি Bearer টোকেন পাঠান। অ্যাকাউন্টের অনুমতি ও আইপি বিধিনিষেধ তবুও প্রযোজ্য থাকবে। অভ্যন্তরীণ ওয়ার্কারের পরিচয়প্রমাণ ব্যবহার করবেন না।
নথি আপলোড করুন
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--form-string from_number=+12125550123 \
--form-string to_number=+12125550124 \
--form fax_file=@./document.pdf \
https://api.multitel.net/v3/send_fax| ক্ষেত্র | আবশ্যক | অর্থ |
|---|---|---|
from_number | হ্যাঁ | প্রেরক হিসেবে ব্যবহারের জন্য আপনার অনুমোদিত নম্বর। শুরুতে + ও দেশের কোড দিয়ে আন্তর্জাতিক বিন্যাস ব্যবহার করুন। |
to_number | হ্যাঁ | আন্তর্জাতিক বিন্যাসে প্রাপকের ফ্যাক্স নম্বর। |
fax_file | মাল্টিপার্টের জন্য হ্যাঁ | আপলোড করা নথি। মাল্টিপার্ট Content-Type ও অংশগুলোর বিভাজক সীমানা curl-কে নির্ধারণ করতে দিন। |
webhook_url | না | ঐচ্ছিক HTTP বা HTTPS কলব্যাক ঠিকানা; HTTPS ব্যবহার করাই ভালো। কলব্যাকে পাঠানো তথ্য ও তা পৌঁছানোর নিশ্চয়তা এখনো পর্যালোচনাধীন: নথিভুক্ত অবস্থা জানার কার্যপ্রবাহ অনুসরণ করতে নিয়মিত fax_status যাচাই করুন। |
JSON-ও গ্রহণ করা হয় নিচের হেডারসহ: Content-Type: application/json, সঙ্গে একই নম্বরের ক্ষেত্রগুলো ও ঐচ্ছিক webhook_url, এবং আরও file_name ও file_b64। file_b64-এ নথির বাইটগুলো কঠোর Base64 বিন্যাসে থাকে, কোনো data: উপসর্গ ছাড়া। বৈধ মাল্টিপার্ট fax_file অগ্রাধিকার পায়। এটি ফাইলের ঠিকানা থেকে ফাইল সংগ্রহ করার API নয়।
নথি ও জমা দেওয়ার সীমা
অ্যাপ্লিকেশনটি pdf, tif, tiff, jpg, jpeg, png, doc, docx বা txt এক্সটেনশনযুক্ত নথির সর্বোচ্চ 15,728,640 ডিকোড করা বাইট (15 MiB) গ্রহণ করে। অনুমোদিত এক্সটেনশন থাকলেই পরিষেবাটি পৃষ্ঠা গণনা বা রূপান্তর করতে পারবে, এমন নিশ্চয়তা নেই। অবকাঠামোর অনুরোধসীমা আরও কম হতে পারে, এবং Base64 অনুরোধের আকার বাড়ায়।
বর্তমান অ্যাপ্লিকেশনটি প্রতিটি অ্যাকাউন্টে একই গন্তব্যের জন্য সারিতে থাকা বা পাঠানো হচ্ছে এমন একটি কাজের অনুমতি দেয়; আগের এক ঘণ্টায় সেই গন্তব্যে সর্বোচ্চ পাঁচবার এবং সব গন্তব্য মিলিয়ে সর্বোচ্চ 50 বার জমা দেওয়া যায়। অনুরোধের হারসীমা সংক্রান্ত প্রতিক্রিয়ায় API কোড 429 ব্যবহৃত হয়। আবার চেষ্টা করার আগে অপেক্ষা করুন; সীমা এড়িয়ে যাওয়ার চেষ্টা করবেন না।
কাজের আইডি সংরক্ষণ করুন
HTTP ফলাফল এবং JSON-এর status.code দুটোই পড়ুন। JSON-এ ব্যর্থতার তথ্য HTTP 200-এর সঙ্গেও আসতে পারে। সফল JSON প্রতিক্রিয়ায় status ও response থাকে; উদাহরণগুলোতে কাল্পনিক তথ্য ব্যবহার করা হয়েছে।
{
"status": {
"code": 200,
"msg": "Fax queued"
},
"response": {
"job_id": "0123456789abcdef0123456789abcdef"
}
}নিয়মিত যাচাই করুন fax_status — response.job_id ব্যবহার করে। পাঠানোর প্রতিক্রিয়া হারিয়ে গেলে আবার পাঠানোর আগে পোর্টালের বহির্গামী ফ্যাক্সের তালিকা দেখুন: একই অনুরোধ বারবার করলে আলাদা আলাদা প্রেরণ তৈরি হতে পারে। একই অনুরোধ পুনরাবৃত্তি করলেও একই ফল বজায় রাখার জন্য ক্লায়েন্টের ব্যবহারের কোনো প্যারামিটার এই হ্যান্ডলারটি দেয় না।
ত্রুটি ও ব্যালেন্স পরীক্ষা
API কোডগুলোর মধ্যে রয়েছে: কোনো ক্ষেত্র অনুপস্থিত, কলব্যাক ঠিকানা অবৈধ, নথি প্রত্যাখ্যাত বা পৃষ্ঠা শনাক্তকরণ ব্যর্থ হলে 400; প্রমাণীকরণ অনুপস্থিত হলে 401; ফ্যাক্সের আনুমানিক খরচের সঙ্গে সারিতে থাকা বা পাঠানো হচ্ছে এমন কাজগুলোর আনুমানিক খরচ যোগ করে অ্যাকাউন্টের উপলব্ধ ব্যালেন্স ছাড়িয়ে গেলে 402; অনুরোধের হারসীমার জন্য 429; এবং প্রেরণের প্রস্তুতিমূলক ধাপে ব্যর্থতার জন্য 500। নির্দিষ্ট কারণ জানতে status.msg পড়ুন।
প্রেরণের আগে সারিতে একটি আনুমানিক খরচ নথিভুক্ত হয়। অনুরোধ গৃহীত হওয়া, ব্যালেন্স পরীক্ষা বা এই আনুমানিক খরচকে চার্জ সম্পন্ন হওয়ার নিশ্চিত প্রমাণ হিসেবে ধরবেন না। চূড়ান্ত বিলিং ও কলব্যাকের বিস্তারিত তথ্য এখনো যাচাইসাপেক্ষ।