Λήψη εγγράφου εξερχόμενου φαξ

Ζητήστε το έγγραφο

Χρησιμοποιήστε έναν ενεργοποιημένο λογαριασμό API της MultiTEL. Στείλτε διαπιστευτήρια HTTP Basic για λογαριασμό με κωδικό πρόσβασης ή ένα διακριτικό Bearer για λογαριασμό με διακριτικό. Τα δικαιώματα του λογαριασμού και οι περιορισμοί διευθύνσεων IP εξακολουθούν να ισχύουν. Μη χρησιμοποιείτε διαπιστευτήρια εσωτερικών διεργασιών επεξεργασίας.

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

Χρησιμοποιήστε το ίδιο υποχρεωτικό job_id σε δεκαεξαδική μορφή 32 χαρακτήρων που χρησιμοποιείται στο fax_status. Το αίτημα πελάτη επιτρέπεται μόνο στον κάτοχο του οποίου η ταυτότητα έχει επαληθευτεί. Αυτό το παράδειγμα αποθηκεύει χωριστά τις κεφαλίδες και τα byte της απόκρισης, ώστε ένα σφάλμα API να μην εκληφθεί ως PDF.

Χειριστείτε ένα αρχείο ή ένα σφάλμα JSON

Σε περίπτωση επιτυχίας, επιστρέφονται τα ακατέργαστα byte του εγγράφου με τις κεφαλίδες συνημμένου Content-Type και Content-Disposition, όχι μια δομή απόκρισης JSON. Ελέγξτε αυτές τις κεφαλίδες πριν ονομάσετε, ανοίξετε ή επεξεργαστείτε το αποθηκευμένο αρχείο. Η απόκριση μπορεί να είναι σε μορφή PDF, TIFF ή στην αρχική μορφή του μεταφορτωμένου αρχείου, ανάλογα με το διαθέσιμο έγγραφο. Μια εργασία στην ουρά μπορεί να επιστρέψει το αρχικό πηγαίο αρχείο της πριν από τη μετατροπή.

Σε περίπτωση αποτυχίας, επιστρέφεται η συνήθης δομή απόκρισης JSON status/response. Ο κωδικός API 400 σημαίνει ότι το job_id λείπει ή έχει εσφαλμένη μορφή· ο 401 σημαίνει ότι λείπει ο έλεγχος ταυτότητας· ο 404 σημαίνει ότι η εργασία ή το αρχείο της δεν είναι διαθέσιμο για αυτόν τον λογαριασμό. Ελέγξτε τα Content-Type και status.code ακόμη και όταν ο κωδικός κατάστασης HTTP είναι 200.

Διαθεσιμότητα και απόρρητο

Η ύπαρξη εγγραφής εργασίας δεν εγγυάται ότι το αρχείο θα παραμένει διαθέσιμο για λήψη για πάντα· δεν έχει επαληθευτεί περίοδος διατήρησης. Όταν χρειάζεται, αποθηκεύστε τα έγγραφα για τα οποία διαθέτετε εξουσιοδότηση σε δικό σας χώρο αποθήκευσης υπό τον έλεγχό σας. Το επιστρεφόμενο αρχείο μπορεί να περιέχει ιδιωτικές πληροφορίες του παραλήπτη. Οι λήψεις δεν αποστέλλουν νέο φαξ.