นักพัฒนา

GET/v3/fax_download?job_id={job_id}

ดาวน์โหลดเอกสารแฟกซ์ขาออก

เรียกเอกสารที่มีอยู่สำหรับงานแฟกซ์ขาออกงานใดงานหนึ่งของคุณ

ในหน้านี้
  1. ขอรับเอกสาร
  2. จัดการไฟล์หรือข้อผิดพลาดในรูปแบบ JSON
  3. ความพร้อมให้เข้าถึงและความเป็นส่วนตัว

ขอรับเอกสาร

ใช้บัญชี API ของ MultiTEL ที่เปิดใช้งานแล้ว ส่งข้อมูลรับรองแบบ 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

ใช้ job_id ที่จำเป็นต้องระบุในรูปเลขฐานสิบหกความยาว 32 อักขระ เช่นเดียวกับที่ใช้กับ 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

ความพร้อมให้เข้าถึงและความเป็นส่วนตัว

การมีระเบียนงานไม่ได้รับประกันว่าจะมีไฟล์ให้ดาวน์โหลดได้ตลอดไป และยังไม่ได้ยืนยันระยะเวลาเก็บรักษา เมื่อจำเป็น ให้บันทึกเอกสารที่คุณมีสิทธิ์เข้าถึงไว้ในพื้นที่จัดเก็บที่คุณควบคุมเอง ไฟล์ที่ส่งกลับมาอาจมีข้อมูลส่วนตัวของผู้รับ การดาวน์โหลดไม่ได้ส่งแฟกซ์ฉบับใหม่