אחזור רשומות השיחות בחשבון
קראו רשומות של שיחות נכנסות או יוצאות בחשבון היישום שלכם ב־API. הרשומות מכילות מידע פרטי על שיחות וחיובים. שמרו אותן בתהליכי עבודה מורשים בצד השרת והימנעו מרישום ביומנים או משיתוף שאינם נחוצים.
לנקודת קצה ותיקה זו יש כיום טווח תאריכים קבוע כברירת מחדל, ללא חלוקה לעמודים. כאשר נדרשת תקופת דיווח אחרת או יצוא נרחב של נתונים היסטוריים, השתמשו בתהליך היסטוריית השיחות והיצוא בפורטל; פרמטרים של תאריכים מותאמים אישית בנקודת קצה זו אינם אמינים.
בקשות
בצעו אימות דרך HTTPS באמצעות חשבון ה־API הפעיל שלכם, מכתובת הרשת המקורית המורשית עבורו. הדוגמה משתמשת בפרטי הזדהות במשתני סביבה. הבקשות הנתמכות לטווח ברירת המחדל אינן דורשות גוף בקשה.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| נתיב | היקף |
|---|---|
| /v3/cdrs | רשומות השיחות הנכנסות בחשבון בטווח התאריכים של ברירת המחדל. |
| /v3/cdrs/{number} | רשומות של שיחות נכנסות שהמספר שלהן תואם בדיוק למספר שסופק. העדיפו את רצף הספרות המלא המשמש במאגר המספרים שלכם. |
| /v3/cdrs/all/outbound | רשומות השיחות היוצאות בחשבון בטווח התאריכים של ברירת המחדל. ענף הטיפול בשיחות יוצאות מתעלם מארגומנט הנתיב הראשון; all משמש כאן כממלא מקום ואינו תו כללי להתאמת שיחות נכנסות. |
השתמשו בערך הכיוון המדויק inbound או outbound המוצג לעיל. ענף הטיפול בשיחות יוצאות אינו מממש סינון לפי מספר. הוספת מספר לנתיב זה אינה מצמצמת את תוצאות השיחות היוצאות.
טווח הדיווח של ברירת המחדל
השאילתה מתחילה בחצות בתאריך שחל 30 ימים לפני היום לפי לוח השנה של השרת, ומסתיימת בחצות בתחילת היום הנוכחי. לכן היא אינה כוללת את יתרת היום הנוכחי. אין זה טווח נע של 720 שעות המסתיים ברגע הנוכחי.
המימוש הנוכחי אינו תומך באופן אמין בשדות הטופס date_from/date_to: כאשר מספקים תאריכים מותאמים אישית, משתני שנת המחיצה שלו נותרים ללא ערך. אל תשתמשו בשדות אלה לדוח בסביבת ייצור. תאריכים במחרוזת השאילתה ופרמטרים לחלוקה לעמודים אינם ממומשים כחלופות.
תגובה
מוצגים רק שדות נבחרים של שיחות נכנסות לצורך המחשה; אלו נתונים בדויים ולא הרשומה המלאה המוחזרת.
{
"status": {
"code": "200",
"msg": "",
"results": 1
},
"response": [
{
"number": "12025550123",
"callerid": "12025550124",
"disposition": "ANSWERED",
"billseconds": "60",
"billcost": "0.0100",
"callsid": "11111111111111111111111111111111",
"date_created": "2026-10-01 12:00:00 UTC"
}
]
}response הוא רשימה. מעטפת התגובה המשותפת עשויה לכלול את status.results כמספר השורות שלה. קודי תוצאה עשויים להיות מחרוזות. כאשר אין רשומות, התוצאה משתמשת בקוד API שמספרו 404 ובהודעה No entries found, במקום ברשימה ריקה המסמנת הצלחה.
שדות הרשומה
| שדות | משמעות |
|---|---|
| number, callerid | מספר השיחה הנכנסת ומזהה המתקשר בבחירת השדות של שיחות נכנסות. |
| calling, called, callerid | מזהי הצד המתקשר והצד שאליו מתקשרים בבחירת השדות של שיחות יוצאות. אין להסיק ממזהה המתקשר שזהות המנוי אומתה. |
| disposition, billseconds, billcost | מצב סיום השיחה השמור, משך הזמן שחויב וסכום החיוב השמור. הערכים עשויים להשתמש בתבניות מחרוזת ותיקות של מסד הנתונים. |
| callsid | מזהה ה־UUID השמור של השיחה, לצורך קישור בין רשומות. |
| date_created | מחרוזת תאריך ושעה עם הסיומת המילולית UTC, ולא חותמת זמן שמובטח כי היא בתבנית ISO8601. נתחו את התבנית המוחזרת באופן מפורש. |
| שדות נוספים | רשומות של שיחות נכנסות כוללות גם נתוני אבחון של כשלים, עלות, ערוץ, איכות ומקור; רשומות של שיחות יוצאות כוללות נתוני אבחון של אזור סיום השיחה. התגובה המלאה עשויה לכלול מידע על התשתית ויש להתייחס אליה כמידע פרטי. |
נקודת הקצה אינה מוסיפה מיון מפורש או חלוקה לעמודים. אל תניחו שהתוצאות מסודרות מהחדשות לישנות, שסדר השורות קבוע או שקיים סמן לסנכרון מצטבר. שדות החיוב המוחזרים הם נתונים מרשומות שיחות שמורות, ולא הצעת מחיר לשיחה עתידית.
שגיאות ומגבלות דיווח
קראו הן את סטטוס ה־HTTP והן את status.code/status.msg ב־JSON. כאשר אין רשומות בחשבון ובטווח שנבחרו, מוחזר קוד API שמספרו 404. חלות גם דרישות אימות והגבלות על כתובת הרשת שממנה נשלחת הבקשה. דוח גדול ללא חלוקה לעמודים או בקשה לא אמינה לתאריכים מותאמים אישית עלולים להיכשל; תשאול חוזר של הטבלה כולה אינו אסטרטגיה ליצוא מצטבר.
רכיב הטיפול שנבדק מכיל שאילתות קריאה ואינו מחייב את החשבון או יוזם שיחות. רשומה מוחזרת אינה מוכיחה שאדם ענה לשיחה; פרשו את מצב סיום השיחה ואת משכה השמורים בהתאם לצורכי הדיווח שלכם.