ანგარიშის ზარების ჩანაწერების წაკითხვა

ანგარიშის ზარების ჩანაწერების მიღება

წაიკითხეთ თქვენი API ანგარიშის შემომავალი ან გამავალი ზარების ჩანაწერები. ეს ჩანაწერები შეიცავს ზარებისა და დარიცხვების კონფიდენციალურ ინფორმაციას. გამოიყენეთ ისინი სერვერის მხარეს მხოლოდ ავტორიზებულ სამუშაო პროცესებში და მოერიდეთ მათ არასაჭირო ჩაწერას ჟურნალებში ან გაზიარებას.

ამ მოძველებულ საბოლოო წერტილს ამჟამად აქვს ფიქსირებული ნაგულისხმევი თარიღების დიაპაზონი და არ აქვს გვერდებად დაყოფა. თუ სხვა საანგარიშო პერიოდი ან წარსული მონაცემების დიდი მოცულობით ექსპორტი გჭირდებათ, გამოიყენეთ პორტალის ზარების ისტორიისა და ექსპორტის სამუშაო პროცესი; ამ საბოლოო წერტილში მორგებული თარიღის პარამეტრები საიმედო არ არის.

მოთხოვნები

გაიარეთ ავთენტიფიკაცია HTTPS პროტოკოლით, თქვენი გააქტიურებული API ანგარიშის გამოყენებით, მისთვის ნებადართული წყაროს IP მისამართიდან. მაგალითში ავტორიზაციის მონაცემები გარემოს ცვლადებშია მოთავსებული. მხარდაჭერილი ნაგულისხმევი პერიოდის მოთხოვნებს სხეული არ სჭირდება.

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 სტატუსი, ისე JSON პასუხის status.code/status.msg. თუ არჩეულ ანგარიშში ან პერიოდში ჩანაწერები არ არის, ბრუნდება API კოდი 404. ასევე მოქმედებს ავთენტიფიკაციისა და წყაროს IP მისამართის შეზღუდვები. დიდი, გვერდებად დაუყოფელი ანგარიშის ან არასაიმედო მორგებული თარიღის მოთხოვნა შეიძლება წარუმატებლად დასრულდეს; სრული ცხრილის განმეორებით გამოთხოვა ეტაპობრივი ექსპორტის სტრატეგია არ არის.

შემოწმებული დამმუშავებელი შეიცავს წაკითხვის მოთხოვნებს და არ შეიცავს ანგარიშიდან თანხის ჩამოჭრას ან ზარის წამოწყებას. დაბრუნებული ჩანაწერი არ ადასტურებს, რომ ზარს ადამიანმა უპასუხა; შენახული შედეგი და ხანგრძლივობა თქვენი ანგარიშგების საჭიროებების შესაბამისად განმარტეთ.