SMSMobileAPI – Τεκμηρίωση API Διαχείρισης Κλήσεων

Τεκμηρίωση API διαχείρισης κλήσεων

Αυτά τα τελικά σημεία σάς επιτρέπουν να ανακτήσετε τα δεδομένα σας Αναπάντητες κλήσεις, Εισερχόμενες Απαντημένες Κλήσεις, και Εξερχόμενες κλήσεις συγχρονισμένο από την εφαρμογή SMSMobileAPI για κινητά στον πίνακα ελέγχου + το API σας.

Σημαντικό: εάν η εφαρμογή για κινητά εκτελείται στο παρασκήνιο, το τηλεφωνικό σύστημα ενδέχεται να επιβάλει καθυστέρηση (συχνά έως και ~10 λεπτά) μεταξύ των συγχρονισμών. Μπορείτε πάντα να ανοίξετε την εφαρμογή για να συγχρονίσετε χειροκίνητα, εάν χρειάζεται.

Υποστήριξη: api@smsmobileapi.com

Ερευνα

Γρήγορη εκκίνηση

Βασική διεύθυνση URL

ΠΑΙΡΝΩhttps://api.smsmobileapi.com

Όλα τα παρακάτω τελικά σημεία καταγράφονται ως ΠΑΙΡΝΩ αιτήματα. Αντικατάσταση Το_κλειδί_του_API_σας με το πραγματικό σας κλειδί (μην το κοινοποιήσετε δημόσια).

Παραδείγματα


ΑΠΟΚΤΗΣΤΕ https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY


ΛΗΨΗ https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc


ΛΗΨΗ https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&q=3247&date_from_ms=1700000000000&date_to_ms=1700864000000

Πιστοποίηση

Τα τελικά σημεία διαχείρισης κλήσεων ελέγχουν τον έλεγχο ταυτότητας χρησιμοποιώντας το apikey παράμετρος ερωτήματος.

Επικύρωση συνδρομής: Τα εισερχόμενα/εξερχόμενα τελικά σημεία επικυρώνουν το κλειδί API σας και ελέγχουν την εγκυρότητα της συνδρομής σας (βάσει Όριο ημερομηνίας >= CURDATE()). Εάν λήξει, θα λάβετε api_expiredΤο τελικό σημείο των αναπάντητων κλήσεων ενδέχεται να επιστρέψει ένα γενικό σφάλμα "Λείπει το apikey" / διακομιστή ανάλογα με τις συνθήκες.

Κοινές έννοιες

Σελιδοποίηση

Χρήση όριο και όφσετ για την σελιδοποίηση των αποτελεσμάτων.

Χρονικές σημάνσεις

call_date_ms είναι μια χρονική σήμανση UNIX στο χιλιοστά του δευτερολέπτου.
ημερομηνία_κλήσης_ώρα_utc αποθηκεύεται ως συμβολοσειρά ημερομηνίας/ώρας UTC (πεδίο βάσης δεδομένων).
Για τις αναπάντητες κλήσεις, το API επιστρέφει μια μορφοποιημένη ημερομηνία συμβολοσειρά (που προκύπτει από μια τιμή χιλιοστών του δευτερολέπτου).

Ερευνα

Αναπάντητες κλήσεις: έρευνα ταιριάζει με τον αριθμό ή το όνομα.
Εισερχόμενες/Εξερχόμενες: q αντιστοιχεί στο phone_number ή στο cached_name.

Ταξινόμηση (Μόνο εισερχόμενες/εξερχόμενες)

Η ταξινόμηση ελέγχεται από ταξινόμηση_κατά + ταξινόμηση_κατάλογος (μόνο πεδία στη λίστα επιτρεπόμενων). Οι αναπάντητες κλήσεις ταξινομούνται πάντα με βάση τις νεότερες.

Σφάλματα

HTTP	Παράδειγμα σφάλματος	Εννοια
400	`{"επιτυχία":false,"σφάλμα":"missing_apikey"}`	Λείπει ή είναι κενό `apikey`.
403	`{"επιτυχία":false,"σφάλμα":"invalid_apikey"}`	Το κλειδί API δεν βρέθηκε / δεν αναγνωρίστηκε.
403	`{"επιτυχία":false,"σφάλμα":"api_expired"}`	Η συνδρομή σας έχει λήξει (`Όριο ημερομηνίας` είναι πριν από σήμερα).
500	`{"επιτυχία":false,"σφάλμα":"σφάλμα_διακομιστή","λεπτομέρεια":"..."}`	Σφάλμα διακομιστή (βάση δεδομένων, SQL, εξαίρεση).

Σημείωση: το τελικό σημείο Αναπάντητων Κλήσεων μπορεί επίσης να επιστρέψει μηνύματα όπως Λείπει το apikey ή σφάλματα προετοιμασίας SQL ανάλογα με την περίπτωση.

Αναπάντητες κλήσεις – Λίστα

Ανάκτηση αναπάντητων κλήσεων που έχουν συγχρονιστεί από την κινητή συσκευή.

Τελικό σημείο

ΠΑΙΡΝΩhttps://api.smsmobileapi.com/call/missed/list/

Παράμετροι ερωτήματος

Παράμετρος	Τύπος	Περιγραφή
Υποχρεούμαι`apikey`	σειρά	Το κλειδί API σας συνδέεται με το κινητό τηλέφωνο.
Προαιρετικός`όφσετ`	εσωτ.	Μετατόπιση σελιδοποίησης (προεπιλογή: `0`).
Προαιρετικός`όριο`	εσωτ.	Μέγιστος αριθμός γραμμών προς επιστροφή (προεπιλογή: `100`, μέγ.: `500`).
Προαιρετικός`έρευνα`	σειρά	Αναζήτηση με αριθμό ή όνομα (SQL LIKE).
Προαιρετικός`ημερομηνία_έναρξης`	ΕΕΕΕ-ΜΜ-ΗΗ	Φιλτράρισμα από αυτήν την ημέρα (00:00:00). Σε σύγκριση με την αποθηκευμένη χρονική σήμανση χιλιοστών του δευτερολέπτου.
Προαιρετικός`ημερομηνία_τέλους`	ΕΕΕΕ-ΜΜ-ΗΗ	Φιλτράρισμα έως αυτήν την ημέρα (23:59:59). Σε σύγκριση με την αποθηκευμένη χρονική σήμανση χιλιοστών του δευτερολέπτου.

Ταξινόμηση

Διορθώθηκε: πρώτα τα νεότερα (ΤΑΞΙΝΟΜΗΣΗ ΜΕ ΗΜΕΡΟΜΗΝΙΑ ΠΕΡΙΓΡΑΦΗ).

Παράδειγμα αιτήματος


ΛΗΨΗ https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&limit=100&offset=0&search=John&date_start=2026-02-01&date_end=2026-02-24

Παράδειγμα απάντησης

{ "επιτυχία": true, "offset": 0, "limit": 100, "count": 2, "data": [ { "αριθμός": "+123470000000", "όνομα": "John Doe", "ημερομηνία": "2026-02-24 12:49:39" }, { "αριθμός": "+123471111111", "όνομα": "", "ημερομηνία": "2026-02-24 11:12:09" } ] }

Εισερχόμενες κλήσεις – Λίστα

Ανάκτηση εισερχόμενων απαντημένων κλήσεων που έχουν συγχρονιστεί από την κινητή συσκευή.

Τελικό σημείο

ΠΑΙΡΝΩhttps://api.smsmobileapi.com/call/incoming/list/

Παράμετροι ερωτήματος

Παράμετρος	Τύπος	Περιγραφή
Υποχρεούμαι`apikey`	σειρά	Το κλειδί API σας. Επικυρώθηκε έναντι συνδρομής (`Όριο ημερομηνίας`).
Προαιρετικός`όριο`	εσωτ.	Γραμμές ανά σελίδα (προεπιλογή: `50`, ελάχιστο 1, μέγιστο `200`).
Προαιρετικός`όφσετ`	εσωτ.	Μετατόπιση σελιδοποίησης (προεπιλογή: `0`).
Προαιρετικός`ταξινόμηση_κατά`	σειρά	Πεδίο ταξινόμησης (προεπιλογή: `call_date_ms`). Επιτρέπονται: `call_date_ms`, `ημερομηνία_κλήσης_ώρα_utc`, `διάρκεια_δευτερόλεπτο`, `αριθμός_τηλεφώνου`, `δημιουργήθηκε_στις`, `προσωρινά αποθηκευμένο_όνομα`, `γεωγραφική_τοποθεσία`.
Προαιρετικός`ταξινόμηση_κατάλογος`	αύξουσα\|περιστροφή	Κατεύθυνση ταξινόμησης (προεπιλογή: `περιγραφή`).
Προαιρετικός`ημερομηνία_από_ms`	ακέραιος αριθμός (ms)	Φιλτράρισμα πού `call_date_ms >= date_from_ms`.
Προαιρετικός`ημερομηνία_έως_ms`	ακέραιος αριθμός (ms)	Φιλτράρισμα πού `call_date_ms <= date_to_ms`.
Προαιρετικός`q`	σειρά	Αναζήτηση (ΜΟΥ ΑΡΕΣΕ) στο `αριθμός_τηλεφώνου` ή `προσωρινά αποθηκευμένο_όνομα`.

Παράδειγμα αιτήματος


ΛΗΨΗ https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=100&offset=0&sort_by=call_date_ms&sort_dir=desc&q=3247

Παράδειγμα απάντησης

{ "επιτυχία": true, "apikey": "YOUR_API_KEY", "limit": 100, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": "+12347" }, "count": 2, "rows": [ { "phone_number": "+123470000000", "cached_name": "Matteo Css", "call_date_ms": 1761233379000, "call_datetime_utc": "2026-02-23 12:49:39", "duration_sec": 440, "geo_location": "Βέλγιο", "created_at": "2026-02-24 04:14:38" } ] }

Εξερχόμενες κλήσεις – Λίστα

Ανάκτηση εξερχόμενων κλήσεων που έχουν συγχρονιστεί από την κινητή συσκευή.

Τελικό σημείο

ΠΑΙΡΝΩhttps://api.smsmobileapi.com/call/outgoing/list/

Παράμετροι ερωτήματος

Ίδιες παράμετροι και συμπεριφορά όπως και στις εισερχόμενες κλήσεις.

Παράμετρος	Τύπος	Περιγραφή
Υποχρεούμαι`apikey`	σειρά	Το κλειδί API σας. Επικυρώθηκε έναντι συνδρομής (`Όριο ημερομηνίας`).
Προαιρετικός`όριο`	εσωτ.	Γραμμές ανά σελίδα (προεπιλογή: `50`, μέγ. `200`).
Προαιρετικός`όφσετ`	εσωτ.	Μετατόπιση σελιδοποίησης (προεπιλογή: `0`).
Προαιρετικός`ταξινόμηση_κατά`	σειρά	Αθέτηση `call_date_ms`Επιτρέπονται: `call_date_ms`, `ημερομηνία_κλήσης_ώρα_utc`, `διάρκεια_δευτερόλεπτο`, `αριθμός_τηλεφώνου`, `δημιουργήθηκε_στις`, `προσωρινά αποθηκευμένο_όνομα`, `γεωγραφική_τοποθεσία`.
Προαιρετικός`ταξινόμηση_κατάλογος`	αύξουσα\|περιστροφή	Αθέτηση `περιγραφή`.
Προαιρετικός`ημερομηνία_από_ms`	ακέραιος αριθμός (ms)	Φιλτράρισμα από αυτήν τη χρονική σήμανση (ms).
Προαιρετικός`ημερομηνία_έως_ms`	ακέραιος αριθμός (ms)	Φιλτράρετε έως αυτήν τη χρονική σήμανση (ms).
Προαιρετικός`q`	σειρά	Αναζήτηση σε `αριθμός_τηλεφώνου` ή `προσωρινά αποθηκευμένο_όνομα`.

Παράδειγμα αιτήματος


ΑΠΟΚΤΗΣΤΕ https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=duration_sec&sort_dir=desc&date_from_ms=1700000000000&date_to_ms=1700864000000

Παράδειγμα απάντησης

{ "επιτυχία": true, "apikey": "YOUR_API_KEY", "όριο": 50, "offset": 0, "sort_by": "duration_sec", "sort_dir": "desc", "filters": { "date_from_ms": "1700000000000", "date_to_ms": "1700864000000", "q": null }, "count": 1, "rows": [ { "phone_number": "+123490000000", "cached_name": null, "call_date_ms": 1761231000000, "call_datetime_utc": "2026-02-23 12:10:00", "duration_sec": 120, "geo_location": "Βέλγιο", "created_at": "2026-02-24 04:14:37" } ] }

Πεδία αναπάντητων κλήσεων

Πεδίο	Τύπος	Περιγραφή
`επιτυχία`	βουλ	Κατάσταση αιτήματος.
`όφσετ`	εσωτ.	Επιστράφηκε μετατόπιση σελιδοποίησης.
`όριο`	εσωτ.	Επιστράφηκε όριο σελιδοποίησης.
`κόμης`	εσωτ.	Αριθμός γραμμών που επιστράφηκαν σε `δεδομένα`.
`δεδομένα`	παράταξη	Λίστα αναπάντητων κλήσεων.
`δεδομένα[].αριθμός`	σειρά	Αριθμός τηλεφώνου καλούντος.
`δεδομένα[].όνομα`	σειρά	Όνομα επαφής που έχει αποθηκευτεί στην προσωρινή μνήμη (μπορεί να είναι κενό).
`δεδομένα[].ημερομηνία`	σειρά	Μορφοποιημένη συμβολοσειρά ημερομηνίας/ώρας που προέρχεται από χρονική σήμανση χιλιοστών του δευτερολέπτου.

Πεδία εισερχόμενων/εξερχόμενων

Πεδίο	Τύπος	Περιγραφή
`επιτυχία`	βουλ	Κατάσταση αιτήματος.
`apikey`	σειρά	Επαναλαμβάνεται από το API (το κλειδί σας).
`όριο`	εσωτ.	Επιστρεφόμενες γραμμές ανά σελίδα.
`όφσετ`	εσωτ.	Επιστράφηκε μετατόπιση σελιδοποίησης.
`ταξινόμηση_κατά`	σειρά	Εφαρμόστηκε πεδίο ταξινόμησης.
`ταξινόμηση_κατάλογος`	σειρά	Εφαρμόστηκε η κατεύθυνση ταξινόμησης.
`φίλτρα`	αντικείμενο	Φίλτρα με ηχώ (`ημερομηνία_από_ms`, `ημερομηνία_έως_ms`, `q`).
`κόμης`	εσωτ.	Αριθμός γραμμών που επιστράφηκαν σε `σειρές`.
`σειρές`	παράταξη	Λίστα κλήσεων.
`γραμμές[].αριθμός_τηλεφώνου`	σειρά	Αριθμός τηλεφώνου.
`γραμμές[].cached_name`	συμβολοσειρά\|null	Όνομα επαφής που έχει αποθηκευτεί στην προσωρινή μνήμη (μπορεί να είναι null).
`γραμμές[].call_date_ms`	εσωτ.	Χρονική σήμανση κλήσης σε χιλιοστά του δευτερολέπτου.
`γραμμές[].call_datetime_utc`	σειρά	Πεδίο ημερομηνίας/ώρας UTC (βάση δεδομένων).
`γραμμές[].διάρκεια_δευτ.`	εσωτ.	Διάρκεια σε δευτερόλεπτα.
`γραμμές[].geo_location`	συμβολοσειρά\|null	Ετικέτα γεωγραφικής τοποθεσίας (μπορεί να είναι κενή/μηδενική).
`γραμμές[].created_at`	σειρά	Χρονική σήμανση εισαγωγής διακομιστή.

API και Έγγραφα προγραμματιστή

Μητρώο εργαλείων και αλλαγών

Τεκμηρίωση API διαχείρισης κλήσεων

Γρήγορη εκκίνηση

Βασική διεύθυνση URL

Παραδείγματα

Πιστοποίηση

Κοινές έννοιες

Σελιδοποίηση

Χρονικές σημάνσεις

Ερευνα

Ταξινόμηση (Μόνο εισερχόμενες/εξερχόμενες)

Σφάλματα

Αναπάντητες κλήσεις – Λίστα

Τελικό σημείο

Παράμετροι ερωτήματος

Ταξινόμηση

Παράδειγμα αιτήματος

Παράδειγμα απάντησης

Εισερχόμενες κλήσεις – Λίστα

Τελικό σημείο

Παράμετροι ερωτήματος

Παράδειγμα αιτήματος

Παράδειγμα απάντησης

Εξερχόμενες κλήσεις – Λίστα

Τελικό σημείο

Παράμετροι ερωτήματος

Παράδειγμα αιτήματος

Παράδειγμα απάντησης

Πεδία αναπάντητων κλήσεων

Πεδία εισερχόμενων/εξερχόμενων

💬 Διαθέσιμη ζωντανή συνομιλία