HTTPS और स्वीकृत API क्रेडेंशियल के साथ HTTP Basic प्रमाणीकरण का उपयोग करें। क्रेडेंशियल अपने एप्लिकेशन सर्वर पर रखें। ये होस्टेड PBX एंडपॉइंट api.multitel.net पर /hpbx/ का उपयोग करते हैं; /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 एकीकरणों के लिए वर्तमान कॉल-इतिहास संदर्भ का उपयोग करें, जिसमें उसका रिस्पांस स्कीमा और खाता अनुमतियाँ शामिल हैं।