Ανάγνωση αρχείων κλήσεων λογαριασμού

Ανάκτηση αρχείων κλήσεων λογαριασμού

Διαβάστε τα αρχεία εισερχόμενων ή εξερχόμενων κλήσεων του λογαριασμού σας 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 όσο και τα status.code/status.msg στο JSON. Η απουσία εγγραφών στον επιλεγμένο λογαριασμό και χρονικό διάστημα επιστρέφει τον κωδικό API 404. Ισχύουν επίσης ο έλεγχος ταυτότητας και οι περιορισμοί διεύθυνσης IP προέλευσης. Μια μεγάλη αναφορά χωρίς σελιδοποίηση ή ένα αναξιόπιστο αίτημα προσαρμοσμένων ημερομηνιών μπορεί να αποτύχει· η επαναλαμβανόμενη ανάκτηση ολόκληρου του πίνακα δεν αποτελεί στρατηγική σταδιακής εξαγωγής.

Ο χειριστής που ελέγχθηκε περιέχει ερωτήματα ανάγνωσης και δεν χρεώνει τον λογαριασμό ούτε ξεκινά κλήσεις. Μια εγγραφή που επιστρέφεται δεν αποδεικνύει ότι απάντησε άνθρωπος· ερμηνεύστε την αποθηκευμένη έκβαση και διάρκεια σύμφωνα με τις ανάγκες της αναφοράς σας.