عرض قائمة مهام الفاكس الصادرة

عرض قائمة مهام الفاكس الصادرة

استخدم حساب MultiTEL مفعلا لواجهة API عبر HTTPS، مع بيانات الاعتماد وقيود عناوين IP المضبوطة له. تعرض نقطة النهاية هذه سجلات الفاكس الصادرة التابعة للحساب الذي تمت مصادقته. لا يؤدي عرض القائمة إلى إرسال فاكس أو إعادة إرساله.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode page=1 \
  --data-urlencode limit=25 \
  --data-urlencode search=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_outbox

لا يدعم هذا المعالج مرشحات date_from أو date_to. يتضمن صندوق الصادر في البوابة مرشحات إضافية يجب عدم نسخها إلى طلب API هذا. ترتب النتائج حسب وقت الإنشاء، من الأحدث إلى الأقدم، دون ترتيب ثانوي حسب المعرّف أو مؤشر لتصفح لقطة ثابتة للبيانات.

قراءة سجلات المهام

اقرأ كلا من نتيجة HTTP والحقل status.code في محتوى JSON. تتضمن الاستجابة الناجحة response.faxes وresponse.pagination؛ ويستخدم المثال بيانات وهمية. يعيد الصندوق الفارغ مصفوفة faxes فارغة، مع قيمة total تساوي 0 وقيمة total_pages تساوي 0.

{
  "status": {"code": 200, "msg": ""},
  "response": {
    "faxes": [{
      "id": 13,
      "uuid": "0123456789abcdef0123456789abcdef",
      "from_number": "+12125550123",
      "to_number": "+12125550124",
      "status": "queued",
      "pages_requested": 3,
      "pages_sent": 0,
      "cost": "0.07500",
      "result_text": "",
      "created_at": "2026-10-01 12:00:00",
      "sent_at": null,
      "updated_at": "2026-10-01 12:00:00"
    }],
    "pagination": {"page": 1, "limit": 25, "total": 1, "total_pages": 1}
  }
}

id هو المعرّف الرقمي للسجل. uuid هو معرّف المهمة الظاهر؛ استخدم معرّف المهمة الذي تعيده send_fax لطلبات الإرسال الجديدة واحتفظ به من أجل الاستعلام الدوري عن الحالة. قد تتضمن القائمة سجلات أقدم، لذا لا تفترض أن كل صف أنشئ عبر نقطة نهاية الإرسال نفسها.

status وresult_text يحملان حالة المعالجة والرسالة المسجلتين. لا توحّد هذه القائمة قيمهما ضمن تعداد شامل لحالات التسليم. تعني حالة الانتظار أن الفاكس في قائمة الانتظار، ولا تعني أنه تم تسليمه. بالنسبة إلى المستندات الحساسة للأهمية، تأكد من الاستلام لدى المستلم قبل اعتبار الفاكس مسلما أو تقديم طلب لإرسال نسخة مكررة.

pages_requested وpages_sent هما قيمتان عدديتان لعدد الصفحات. cost يحتفظ بالقيمة المخزنة، مع استخدام السلسلة النصية 0.00 كقيمة بديلة؛ لا تفترض أن نوعه في JSON مطابق لنوع التكلفة في صندوق الوارد. قد يتضمن السجل الموجود في قائمة الانتظار تقديرا بالفعل. لا تحدد هذه القيمة ولا وجود سجل في القائمة الفوترة النهائية.

created_at، sent_at وupdated_at هي قيم مخزنة بتنسيق الخادم دون إزاحة منطقة زمنية؛ ويمكن أن تكون قيمة sent_at هي null. لا تتضمن القائمة حقل حالة إشعار الويب الذي تعيده نقطة النهاية المنفصلة للاستعلام عن الحالة.

التوفيق بين نتائج الصفحات بأمان

استند إلى pagination.page وlimit وtotal وtotal_pages. قد تكون الصفحات التي تلي الصفحة الأخيرة فارغة. قد تؤدي المهام الجديدة إلى انتقال السجلات بين الصفحات أثناء التصفح. احتفظ بمعرّفات المهام عند دمج نتائج الصفحات؛ فلا تضمن نقطة النهاية هذه لقطة ثابتة للبيانات.

الخصوصية وإعادة المحاولة

تحتوي سجلات صندوق الصادر على بيانات وصفية هاتفية خاصة. احصر صلاحية قراءتها في الأشخاص المصرح لهم وتجنب تسجيل الاستجابات كاملة في السجلات. لا يثبت غياب سجل من القائمة فشل طلب الإرسال: تحقق من معرّف المهمة الذي احتفظت به ومن صندوق الصادر في البوابة قبل إعادة تقديم الطلب. قد ينشئ الإرسال الجديد فاكسا آخر قد تترتب عليه رسوم. لا تزال الضمانات النهائية المتعلقة بعملية التنفيذ والفوترة وإشعارات معاودة الاتصال والاحتفاظ بالبيانات قيد المراجعة.