التحقق من حالة مهمة الفاكس

ابحث عن مهمتك

استخدم حساب MultiTEL API ممكنا. أرسل بيانات اعتماد HTTP Basic لحساب كلمة المرور, أو رمزا مميزا Bearer لحساب الرمز. تظل أذونات الحساب وقيود IP سارية. لا تستخدم بيانات اعتماد العامل الداخلية.

curl --silent --show-error --get --user "$API_USER:$API_PASSWORD" \
  --data-urlencode job_id=0123456789abcdef0123456789abcdef \
  https://api.multitel.net/v3/fax_status

job_id مطلوب ويجب أن يكون المعرف السداسي العشري المكون من 32 حرفا الذي أعاده send_fax. انسخه بالضبط. الطلبات مقيدة بالمالك الموثق.

اقرأ النتيجة

اقرأ نتيجة HTTP وJSON status.code معا. قد تصل إخفاقات JSON مع HTTP 200. تحتوي استجابة JSON الناجحة على status وresponse; وتستخدم الأمثلة بيانات خيالية.

{
  "status": {
    "code": 200,
    "msg": "Fax status"
  },
  "response": {
    "job_id": "0123456789abcdef0123456789abcdef",
    "from_number": "+12125550123",
    "to_number": "+12125550124",
    "status": "queued",
    "result": "",
    "pages_requested": 3,
    "pages_sent": 0,
    "cost": "0.07500",
    "webhook_status": "",
    "created_at": "2026-10-23 10:00:00",
    "updated_at": "2026-10-23 10:00:00"
  }
}

المثال مهمة في قائمة الانتظار, وليس فاكسا تم تسليمه أو عرض سعر. pages_requested هو عدد صفحات المصدر المكتشف; pages_sent يبلغ عن التقدم الذي سجلته المعالجة. cost هو سلسلة عشرية وقد يحتوي بالفعل على تقدير أثناء الانتظار في قائمة الانتظار. result يحمل تفاصيل المعالجة; webhook_status يحمل حالة رد الاتصال المسجلة. الطوابع الزمنية سلاسل منسقة من الخادم دون إزاحة منطقة زمنية.

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

الأخطاء

يعني الرمز API 400 أن job_id مفقود أو مشوه; ويعني 401 أن المصادقة مفقودة; ويعني 404 أن المهمة غير موجودة لهذا الحساب. لا تستدل على الملكية من المعرف وحده.