გასაგზავნი ფაქსის დოკუმენტის ჩამოტვირთვა

დოკუმენტის მოთხოვნა

გამოიყენეთ MultiTEL-ის ჩართული API ანგარიში. პაროლით დაცული ანგარიშისთვის გაგზავნეთ 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

გამოიყენეთ იგივე სავალდებულო 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.

ხელმისაწვდომობა და კონფიდენციალურობა

დავალების ჩანაწერი არ იძლევა გარანტიას, რომ ფაილი სამუდამოდ ხელმისაწვდომი იქნება ჩამოსატვირთად; შენახვის ვადა გადამოწმებული არ არის. საჭიროების შემთხვევაში დოკუმენტები, რომლებზეც წვდომის უფლება გაქვთ, შეინახეთ თქვენს მიერ კონტროლირებად საცავში. დაბრუნებული ფაილი შეიძლება შეიცავდეს მიმღების კონფიდენციალურ ინფორმაციას. ჩამოტვირთვა ახალ ფაქსს არ აგზავნის.