გამოიყენეთ 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"შეცვალეთ ბილინგის კოდი და თარიღები. თარიღის ფილტრები მითითებულ დღეებსაც მოიცავს. ამ ენდპოინთისთვის მოთხოვნის სხეულში არსებული ფილტრები ფორმის მონაცემებად კოდირდება, ხოლო გვერდებად დაყოფის პარამეტრები URL-ის მოთხოვნის სტრიქონშია.
ფილტრები და პასუხი
| პარამეტრი | მნიშვნელობა |
|---|---|
| date_from / date_to | დაწყების/დასრულების თარიღები YYYY-MM-DD ფორმატში. |
| wherelanded | საჭიროების შემთხვევაში დანიშნულების ფილტრი. |
| disposition | ზარის შედეგის ფილტრი, მაგალითად ANSWERED. |
| callerid | დამრეკი ნომრის ფილტრი. |
| timezone | მხარდაჭერილი დროის სარტყლის იდენტიფიკატორი, გამოყენების შემთხვევაში; არ ივარაუდოთ, რომ ის იღებს IANA სახელს. |
| start / length | მოთხოვნის პარამეტრები, რომლებიც აკონტროლებს დაბრუნებულ გვერდს. |
ზარის ჩანაწერები შეიცავს დაწყების დროს, დამრეკის იდენტობას, წყაროს, პირველ დანიშნულების ადგილს, დარიცხვას დაქვემდებარებულ წამებს, ზარის შედეგს და ზარის იდენტიფიკატორებს. გამოიყენეთ ამ ენდპოინტის მიერ დაბრუნებული შედეგის სტრუქტურა; ის შეიძლება განსხვავდებოდეს პორტალის API-ის გვერდებად დაყოფისგან. წარმატებული HTTP მოთხოვნა არ ადასტურებს, რომ შედეგი შესაბამის ზარებს შეიცავს.
გამოიყენეთ ზარების ისტორიის მიმდინარე სახელმძღვანელო პორტალის REST ინტეგრაციებისთვის, მისი პასუხის სქემისა და ანგარიშის ნებართვების ჩათვლით.