भेजे जाने वाले फ़ैक्स का दस्तावेज़ डाउनलोड करें

दस्तावेज़ का अनुरोध करें

सक्रिय 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 हो।

उपलब्धता और गोपनीयता

किसी कार्य का रिकॉर्ड होने से यह गारंटी नहीं मिलती कि उसकी फ़ाइल हमेशा डाउनलोड की जा सकेगी; उसे कितने समय तक रखा जाता है, इसकी पुष्टि नहीं हुई है। आवश्यकता होने पर वे दस्तावेज़ जिन्हें प्राप्त करने की आपको अनुमति है, अपने नियंत्रण वाले भंडारण में सहेजें। लौटाई गई फ़ाइल में प्राप्तकर्ता की निजी जानकारी हो सकती है। डाउनलोड करने से कोई नया फ़ैक्स नहीं भेजा जाता।