استخدم HTTPS ومصادقة HTTP Basic مع بيانات اعتماد API المعتمدة. احتفظ ببيانات الاعتماد على خادم التطبيق لديك. تستخدم نقاط نهاية PBX المستضاف هذه /hpbx/ على api.multitel.net؛ لا تُدرج /v3. تحقق من نتيجة HTTP ومن حالة التطبيق في استجابة JSON معًا.
قراءة سجلات الفاكس
curl --request POST --user "USERNAME:PASSWORD" \
"https://api.multitel.net/hpbx/fax/list/YOUR_BILLING_CODE"استخدم رمز الفوترة الخاص بمقسمك PBX. تشمل السجلات المُعادة وقت الفاكس والاتجاه والمصدر والوجهة وحالة التسليم والمحاولات والأخطاء وعدد الصفحات. قد يظل التسليم قيد الانتظار حتى بعد قبول طلب الإرسال.
إرسال المعلمات
نقطة نهاية الإرسال هي POST /hpbx/fax/send/{billing_code}. الإرسال إجراء فعلي مباشر. جهّز الملف والوجهة المصرّح بها للحساب قبل الإرسال؛ ولا تعِد محاولة إرسال غير مؤكد دون تحقق.
| الحقل | المعنى |
|---|---|
| number | رقم فاكس الوجهة. |
| cidnum | هوية المتصل المعتمدة للإرسال. |
| schedule | وقت الإرسال المجدول، عند استخدامه. |
| faxquality / pagesize / pagerotate | خيارات الجودة وحجم الورق والتدوير المدعومة. |
| statusemail | العنوان المعتمد لإشعارات التسليم. |
| deleteaftersend | تحدد ما إذا كان ينبغي إزالة الملف المرفوع المخزَّن بعد الإرسال. |
| filename | مرجع المستند المتوقع من سير عمل الفاكس هذا؛ وليس مسار ملف محلي عشوائيًا. |
تتبّع الاكتمال
بعد تقديم طلب الإرسال، افحص حالة سجل الفاكس ومحاولاته والخطأ. تحقّق من التسليم الفعلي ولا تعتبر قبول الطلب دليلًا على التسليم. يوثّق مرجع الفاكس في البوابة خطوات الرفع والإرسال الحالية، ومساراتها وآلية مصادقتها منفصلة عن نقطة النهاية أعلاه.