הצגת משימות פקס יוצאות

הצגת משימות פקס יוצאות

השתמשו בחשבון API פעיל של MultiTEL דרך 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 בעת המעבר בין עמודים. עמודים שמעבר לעמוד האחרון עשויים להיות ריקים. משימות חדשות עלולות להזיז רשומות בין עמודים בזמן העיון. שמרו את מזהי המשימות בעת שילוב עמודים; נקודת קצה זו אינה מבטיחה תמונת מצב קבועה.

פרטיות וניסיונות חוזרים

רשומות תיבת הפקסים היוצאים מכילות נתוני טלפוניה נלווים ופרטיים. הגבילו את הרשאות הקריאה שלהן והימנעו מרישום תגובות מלאות ביומנים. היעדר רשומה ברשימה אינו מוכיח שבקשת שליחה נכשלה: בדקו את מזהה המשימה ששמרתם ואת תיבת הפקסים היוצאים בפורטל לפני שתגישו בקשה מחדש. שליחה חדשה עלולה ליצור פקס נוסף שעשוי להיות כרוך בחיוב. ההתחייבויות הסופיות לגבי העיבוד ברקע, החיוב, הקריאות החוזרות ושמירת הנתונים עדיין בבדיקה.