استخدم 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 الخاصة بالبوابة، بما في ذلك مخطط الاستجابة وأذونات الحساب.