Τεκμηρίωση 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=1555&date_from_ms=1700000000000&date_to_ms=1700864000000
Πιστοποίηση
Τα τελικά σημεία διαχείρισης κλήσεων ελέγχουν τον έλεγχο ταυτότητας χρησιμοποιώντας το apikey παράμετρος ερωτήματος.
Επικύρωση συνδρομής: Τα εισερχόμενα/εξερχόμενα τελικά σημεία επικυρώνουν το κλειδί API σας και ελέγχουν την εγκυρότητα της συνδρομής σας (Όριο ημερομηνίας >= CURDATE()). Εάν λήξει, θα λάβετε api_expired.
Κοινές έννοιες
Σελιδοποίηση
Χρήση όριο και όφσετ για την σελιδοποίηση των αποτελεσμάτων.
Χρονικές σημάνσεις
- call_date_ms είναι μια χρονική σήμανση UNIX στο χιλιοστά του δευτερολέπτου.
- ημερομηνία_κλήσης_ώρα_utc αποθηκεύεται ως συμβολοσειρά ημερομηνίας/ώρας UTC (πεδίο βάσης δεδομένων).
- Για τις αναπάντητες κλήσεις, το API επιστρέφει μια μορφοποιημένη ημερομηνία συμβολοσειρά (που προκύπτει από μια τιμή χιλιοστών του δευτερολέπτου).
Ερευνα
- Αναπάντητες κλήσεις: έρευνα ταιριάζει με τον αριθμό ή το όνομα.
- Εισερχόμενες/Εξερχόμενες: q αγώνες αριθμός_τηλεφώνου ή προσωρινά αποθηκευμένο_όνομα.
Ταξινόμηση (Μόνο εισερχόμενες/εξερχόμενες)
Η ταξινόμηση ελέγχεται από ταξινόμηση_κατά + ταξινόμηση_κατάλογος (μόνο πεδία στη λίστα επιτρεπόμενων). Οι αναπάντητες κλήσεις ταξινομούνται πάντα με βάση τις νεότερες.
Όλα τα παραδείγματα απαντήσεων σε αυτήν την τεκμηρίωση είναι ανώνυμοςΤα κλειδιά API, οι αριθμοί τηλεφώνου και τα ονόματα επαφών που εμφανίζονται παρακάτω είναι μόνο ενδεικτικές τιμές.
Σφάλματα
| 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&offset=0&limit=100
Παράδειγμα απόκρισης JSON
{ "επιτυχία": true, "offset": 0, "limit": 100, "count": 3, "data": [ { "αριθμός": "+15551230001", "όνομα": "", "ημερομηνία": "2026-03-20 16:12:28" }, { "αριθμός": "+15551230002", "όνομα": "Άλεξ Κάρτερ", "ημερομηνία": "2026-03-20 16:12:00" }, { "αριθμός": "+447700900123", "όνομα": "Τέιλορ Ριντ", "ημερομηνία": "2026-03-20 15:48:41" } ] }
Εξήγηση απάντησης
| Πεδίο | Περιγραφή |
|---|---|
| επιτυχία | αληθής σημαίνει ότι το αίτημα διεκπεραιώθηκε με επιτυχία. |
| όφσετ | Μετατόπιση σελιδοποίησης που επιστρέφεται από το API. |
| όριο | Εφαρμόστηκε όριο σελιδοποίησης στο αίτημα. |
| κόμης | Αριθμός γραμμών που επιστράφηκαν σε δεδομένα. |
| δεδομένα | Πίνακας που περιέχει καταχωρίσεις αναπάντητων κλήσεων. |
| δεδομένα[].αριθμός | Αριθμός τηλεφώνου καλούντος. |
| δεδομένα[].όνομα | Όνομα επαφής αποθηκευμένο στην προσωρινή μνήμη. Μπορεί να είναι κενό εάν δεν υπάρχει διαθέσιμο όνομα επαφής. |
| δεδομένα[].ημερομηνία | Μορφοποιημένη ημερομηνία και ώρα κλήσης. |
Τα παραπάνω παραδείγματα τιμών είναι ανώνυμα. Οι πραγματικές απαντήσεις ενδέχεται να περιέχουν διαφορετικούς αριθμούς τηλεφώνου και ετικέτες επικοινωνίας.
Εισερχόμενες κλήσεις – Λίστα
Ανάκτηση εισερχόμενων απαντημένων κλήσεων που έχουν συγχρονιστεί από την κινητή συσκευή.
Τελικό σημείο
ΠΑΙΡΝΩ https://api.smsmobileapi.com/call/incoming/list/
Παράμετροι ερωτήματος
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| apikey | σειρά | Υποχρεούμαι Το κλειδί API σας (επικυρωμένο με συνδρομή). |
| όριο | εσωτ. | Προαιρετικός Γραμμές ανά σελίδα (προεπιλογή: 50, μέγ.: 200). |
| όφσετ | εσωτ. | Προαιρετικός Μετατόπιση σελιδοποίησης (προεπιλογή: 0). |
| ταξινόμηση_κατά | σειρά | Προαιρετικός Επιτρέπονται: 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=50&offset=0&sort_by=call_date_ms&sort_dir=desc
Παράδειγμα απόκρισης JSON
{ "επιτυχία": true, "apikey": "YOUR_API_KEY_HASH", "όριο": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230010", "cached_name": "Jordan Blake", "call_date_ms": 1774027779390, "call_datetime_utc": "2026-03-20 17:29:39", "duration_sec": 23, "geo_location": "Καναδάς", "created_at": "2026-03-20 17:46:45" }, { "phone_number": "+15551230011", "cached_name": "Morgan Lee", "call_date_ms": 1774018268663, "call_datetime_utc": "2026-03-20 14:51:08", "duration_sec": 50, "geo_location": "Καναδάς", "created_at": "2026-03-20 14:58:37" }, { "phone_number": "+447700900124", "cached_name": "Sam Parker", "call_date_ms": 1774011205123, "call_datetime_utc": "2026-03-20 12:53:25", "duration_sec": 92, "geo_location": "Καναδάς", "created_at": "2026-03-20 12:59:01" } ] }
Εξήγηση απάντησης
| Πεδίο | Περιγραφή |
|---|---|
| επιτυχία | αληθής σημαίνει ότι το αίτημα διεκπεραιώθηκε με επιτυχία. |
| apikey | Η τιμή κλειδιού API που επαναλαμβάνεται. Στα παραδείγματα τεκμηρίωσης, αυτό θα πρέπει πάντα να είναι καλυμμένο. |
| όριο | Αριθμός γραμμών που ζητούνται ανά σελίδα. |
| όφσετ | Μετατόπιση σελιδοποίησης που επιστρέφεται από το API. |
| ταξινόμηση_κατά | Πεδίο ταξινόμησης που εφαρμόζεται από το API. |
| ταξινόμηση_κατάλογος | Κατεύθυνση ταξινόμησης που εφαρμόζεται από το API. |
| φίλτρα | Αντικείμενο που περιέχει τα ενεργά φίλτρα που χρησιμοποιούνται για το αίτημα. |
| κόμης | Αριθμός γραμμών που επιστράφηκαν σε σειρές. |
| σειρές | Πίνακας που περιέχει καταχωρήσεις εισερχόμενων απαντημένων κλήσεων. |
| γραμμές[].αριθμός_τηλεφώνου | Αριθμός τηλεφώνου που συνδέεται με την κλήση. |
| γραμμές[].cached_name | Όνομα επαφής αποθηκευμένο στην προσωρινή μνήμη. Μπορεί να είναι null ή κενό ανάλογα με τα διαθέσιμα δεδομένα. |
| γραμμές[].call_date_ms | Χρονική σήμανση κλήσης σε χιλιοστά του δευτερολέπτου. |
| γραμμές[].call_datetime_utc | Ημερομηνία και ώρα UTC της κλήσης. |
| γραμμές[].διάρκεια_δευτ. | Διάρκεια κλήσης σε δευτερόλεπτα. |
| γραμμές[].geo_location | Γεωγραφική ετικέτα που σχετίζεται με τον αριθμό, εάν είναι διαθέσιμη. |
| γραμμές[].created_at | Ημερομηνία και ώρα εισαγωγής της γραμμής στον διακομιστή. |
Το API μπορεί να αντικατοπτρίζει το δικό σας apikey στην απόκριση. Σε δημόσια τεκμηρίωση, στιγμιότυπα οθόνης και παραδείγματα, να το αποκρύπτετε πάντα.
Εξερχόμενες κλήσεις – Λίστα
Ανάκτηση εξερχόμενων κλήσεων που έχουν συγχρονιστεί από την κινητή συσκευή.
Τελικό σημείο
ΠΑΙΡΝΩ https://api.smsmobileapi.com/call/outgoing/list/
Παράμετροι ερωτήματος
Ίδιες παράμετροι και συμπεριφορά όπως και στις εισερχόμενες κλήσεις.
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| apikey | σειρά | Υποχρεούμαι Το κλειδί API σας (επικυρωμένο με συνδρομή). |
| όριο | εσωτ. | Προαιρετικός Γραμμές ανά σελίδα (προεπιλογή: 50, μέγ.: 200). |
| όφσετ | εσωτ. | Προαιρετικός Μετατόπιση σελιδοποίησης (προεπιλογή: 0). |
| ταξινόμηση_κατά | σειρά | Προαιρετικός Επιτρέπονται: 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/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc
Παράδειγμα απόκρισης JSON
{ "επιτυχία": true, "apikey": "YOUR_API_KEY_HASH", "όριο": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230020", "cached_name": "Casey Morgan", "call_date_ms": 1774025965645, "call_datetime_utc": "2026-03-20 16:59:25", "duration_sec": 15, "geo_location": "Καναδάς", "created_at": "2026-03-20 17:17:58" }, { "phone_number": "+15551230021", "cached_name": "Taylor Brooks", "call_date_ms": 1774023172638, "call_datetime_utc": "2026-03-20 16:12:52", "duration_sec": 556, "geo_location": "Καναδάς", "created_at": "2026-03-20 16:28:38" }, { "phone_number": "+33198765432", "cached_name": "Jamie Carter", "call_date_ms": 1774019040000, "call_datetime_utc": "2026-03-20 15:04:00", "duration_sec": 61, "geo_location": "Καναδάς", "created_at": "2026-03-20 15:09:11" } ] }
Εξήγηση απάντησης
| Πεδίο | Περιγραφή |
|---|---|
| επιτυχία | αληθής σημαίνει ότι το αίτημα διεκπεραιώθηκε με επιτυχία. |
| apikey | Η τιμή κλειδιού API που επαναλαμβάνεται. Στα παραδείγματα τεκμηρίωσης, αυτό θα πρέπει πάντα να είναι καλυμμένο. |
| όριο | Αριθμός γραμμών που ζητούνται ανά σελίδα. |
| όφσετ | Μετατόπιση σελιδοποίησης που επιστρέφεται από το API. |
| ταξινόμηση_κατά | Πεδίο ταξινόμησης που εφαρμόζεται από το API. |
| ταξινόμηση_κατάλογος | Κατεύθυνση ταξινόμησης που εφαρμόζεται από το API. |
| φίλτρα | Αντικείμενο που περιέχει τα ενεργά φίλτρα που χρησιμοποιούνται για το αίτημα. |
| κόμης | Αριθμός γραμμών που επιστράφηκαν σε σειρές. |
| σειρές | Πίνακας που περιέχει καταχωρίσεις εξερχόμενων κλήσεων. |
| γραμμές[].αριθμός_τηλεφώνου | Αριθμός τηλεφώνου που συνδέεται με την κλήση. |
| γραμμές[].cached_name | Όνομα επαφής αποθηκευμένο στην προσωρινή μνήμη. Μπορεί να είναι null ή κενό ανάλογα με τα διαθέσιμα δεδομένα. |
| γραμμές[].call_date_ms | Χρονική σήμανση κλήσης σε χιλιοστά του δευτερολέπτου. |
| γραμμές[].call_datetime_utc | Ημερομηνία και ώρα UTC της κλήσης. |
| γραμμές[].διάρκεια_δευτ. | Διάρκεια κλήσης σε δευτερόλεπτα. |
| γραμμές[].geo_location | Γεωγραφική ετικέτα που σχετίζεται με τον αριθμό, εάν είναι διαθέσιμη. |
| γραμμές[].created_at | Ημερομηνία και ώρα εισαγωγής της γραμμής στον διακομιστή. |
Τα παραπάνω παραδείγματα τιμών είναι ανώνυμα. Αντικαταστήστε τα με τα δικά σας ζωντανά δεδομένα μόνο σε ιδιωτικά/εσωτερικά εργαλεία, ποτέ σε δημόσια τεκμηρίωση.
Πεδία αναπάντητων κλήσεων
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| επιτυχία | βουλ | Κατάσταση αιτήματος. |
| όφσετ | εσωτ. | Επιστράφηκε μετατόπιση σελιδοποίησης. |
| όριο | εσωτ. | Επιστράφηκε όριο σελιδοποίησης. |
| κόμης | εσωτ. | Αριθμός γραμμών που επιστράφηκαν σε δεδομένα. |
| δεδομένα | παράταξη | Λίστα αναπάντητων κλήσεων. |
| δεδομένα[].αριθμός | σειρά | Αριθμός τηλεφώνου καλούντος. |
| δεδομένα[].όνομα | σειρά | Όνομα επαφής που έχει αποθηκευτεί στην προσωρινή μνήμη (μπορεί να είναι κενό). |
| δεδομένα[].ημερομηνία | σειρά | Μορφοποιημένη συμβολοσειρά ημερομηνίας/ώρας που προέρχεται από χρονική σήμανση χιλιοστών του δευτερολέπτου. |
Πεδία εισερχόμενων/εξερχόμενων
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| επιτυχία | βουλ | Κατάσταση αιτήματος. |
| apikey | σειρά | Επαναλαμβάνεται από το API (το κλειδί σας). Στα δημόσια έγγραφα, να το χρησιμοποιείτε πάντα ως μάσκα. |
| όριο | εσωτ. | Επιστρεφόμενες γραμμές ανά σελίδα. |
| όφσετ | εσωτ. | Επιστράφηκε μετατόπιση σελιδοποίησης. |
| ταξινόμηση_κατά | σειρά | Εφαρμόστηκε πεδίο ταξινόμησης. |
| ταξινόμηση_κατάλογος | σειρά | Εφαρμόστηκε η κατεύθυνση ταξινόμησης. |
| φίλτρα | αντικείμενο | Φίλτρα με ηχώ (ημερομηνία_από_ms, ημερομηνία_έως_ms, q). |
| κόμης | εσωτ. | Αριθμός γραμμών που επιστράφηκαν σε σειρές. |
| σειρές | παράταξη | Λίστα κλήσεων. |
| γραμμές[].αριθμός_τηλεφώνου | σειρά | Αριθμός τηλεφώνου. |
| γραμμές[].cached_name | συμβολοσειρά|null | Όνομα επαφής που έχει αποθηκευτεί στην προσωρινή μνήμη (μπορεί να είναι null). |
| γραμμές[].call_date_ms | εσωτ. | Χρονική σήμανση κλήσης σε χιλιοστά του δευτερολέπτου. |
| γραμμές[].call_datetime_utc | σειρά | Πεδίο ημερομηνίας/ώρας UTC (βάση δεδομένων). |
| γραμμές[].διάρκεια_δευτ. | εσωτ. | Διάρκεια σε δευτερόλεπτα. |
| γραμμές[].geo_location | συμβολοσειρά|null | Ετικέτα γεωγραφικής τοποθεσίας (μπορεί να είναι κενή/μηδενική). |
| γραμμές[].created_at | σειρά | Χρονική σήμανση εισαγωγής διακομιστή. |
English 
French 
German 
Spanish 
Portuguese 
Russian 
Finnish 
Japanese 
Chinese 
Vietnamese 
Dutch 
Greek 
Arabic 
Danish 
Italian 
Ukrainian