בדיקת מצב משימת פקס

איתור המשימה שלכם

השתמשו בחשבון 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 וגם את השדה status.code של JSON. כשלי 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 מציין שהמשימה לא נמצאה עבור חשבון זה. אל תסיקו בעלות מהמזהה בלבד.