השתמשו ב-HTTPS ובאימות HTTP Basic עם פרטי גישה מאושרים ל-API. שמרו את פרטי הגישה בשרת היישום שלכם. נקודות הקצה האלה של מרכזיית PBX מתארחת משתמשות ב-/hpbx/ ב-api.multitel.net; אל תוסיפו /v3. בדקו גם את תוצאת ה-HTTP וגם את סטטוס היישום בתגובת ה-JSON.
בקשו טווח תאריכים מוגבל
curl --request POST --user "USERNAME:PASSWORD" \
--data-urlencode "date_from=2026-10-01" \
--data-urlencode "date_to=2026-10-02" \
--data-urlencode "disposition=ANSWERED" \
"https://api.multitel.net/hpbx/cdrs/YOUR_BILLING_CODE?start=0&length=50"החליפו את קוד החיוב ואת התאריכים. מסנני התאריכים כוללים את הימים שצוינו. בנקודת קצה זו המסננים בגוף הבקשה מקודדים כנתוני טופס, ופרמטרי החלוקה לעמודים נמצאים במחרוזת השאילתה.
מסננים ותגובה
| פרמטר | משמעות |
|---|---|
| date_from / date_to | תאריכי התחלה/סיום בפורמט YYYY-MM-DD. |
| wherelanded | מסנן יעד בעת הצורך. |
| disposition | מסנן תוצאות שיחה, למשל ANSWERED. |
| callerid | מסנן מספר מתקשר. |
| timezone | מזהה אזור הזמן הנתמך, כאשר נעשה בו שימוש; אל תניחו שהוא מקבל שם IANA. |
| start / length | פרמטרי שאילתה השולטים בעמוד המוחזר. |
רשומות שיחה מכילות שעת התחלה, זהות המתקשר, מקור, היעד הראשון, שניות לחיוב, תוצאת השיחה ומזהי שיחה. השתמשו במבנה התוצאה המוחזר עבור נקודת קצה זו; הוא עשוי להיות שונה מחלוקת התוצאות לעמודים ב-API של הפורטל. בקשת HTTP מוצלחת אינה הוכחה לכך שהתוצאה מכילה שיחות תואמות.
השתמשו בתיעוד העדכני של היסטוריית השיחות לאינטגרציות REST של הפורטל, כולל סכמת התגובה והרשאות החשבון.