تنزيل مستند فاكس صادر

طلب المستند

استخدم حساب 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. يقتصر طلب العميل على المالك الذي تمت مصادقته. يحفظ هذا المثال ترويسات الاستجابة وبايتاتها بشكل منفصل حتى لا يُظن أن خطأ 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.

التوافر والخصوصية

لا يضمن وجود سجل للمهمة بقاء الملف متاحاً للتنزيل إلى الأبد؛ ولم يتم التحقق من مدة الاحتفاظ به. احفظ المستندات التي يُسمح لك بالوصول إليها في مساحة تخزين خاصة بك وتحت سيطرتك عند الحاجة. قد يحتوي الملف المُرجع على معلومات خاصة بالمستلم. لا تؤدي عمليات التنزيل إلى إرسال فاكس جديد.