Τεκμηρίωση API ειδοποιήσεων
Αυτά τα τελικά σημεία σάς επιτρέπουν αποστολή εσωτερικών ειδοποιήσεων για κινητά και ανάκτηση ιστορικού ειδοποιήσεων από το SMSMobileAPI. Οι ειδοποιήσεις μπορούν να αποστέλλονται σε μια συγκεκριμένη κινητή συσκευή και στη συνέχεια να παρακολουθούνται μέσω του τελικού σημείου της λίστας.
Ο ειδοποίηση/λίστα Το τελικό σημείο επιστρέφει την ώρα αποστολής ειδοποίησης και την ώρα διανομής GMT, συμπεριλαμβανομένων πλήρων συμβολοσειρών ημερομηνίας/ώρας και Χρονικές σημάνσεις Unix.
Χρειάζεστε βοήθεια; api@smsmobileapi.com
Γρήγορη εκκίνηση
Βασική διεύθυνση URL
ΠΑΙΡΝΩ https://api.smsmobileapi.com
Όλα τα παρακάτω παραδείγματα παρουσιάζονται ως ΠΑΙΡΝΩ αιτήματα για απλότητα. Το ειδοποίηση/αποστολή το τελικό σημείο δέχεται επίσης ΘΕΣΗ και Σώμα JSONΑντικατάσταση Το_κλειδί_του_API_σας με το πραγματικό σου κλειδί.
Παραδείγματα
ΛΗΨΗ https://api.smsmobileapi.com/notification/send?apikey=YOUR_API_KEY&sid=TARGET_SIDENTIFIANT&title=Notification&message=Helloworld&type=notification
ΛΗΨΗ https://api.smsmobileapi.com/notification/list/?apikey=YOUR_API_KEY
ΛΗΨΗ https://api.smsmobileapi.com/notification/list/?apikey=YOUR_API_KEY&sidentifiant=TARGET_SIDENTIFIANT&distribued=1&date_from=2026-03-01&date_to=2026-03-18
Πιστοποίηση
Τα τελικά σημεία ειδοποιήσεων ελέγχονται χρησιμοποιώντας το apikey παράμετρος.
Απαιτείται και στα δύο τελικά σημεία: Το κλειδί API είναι υποχρεωτικό για
ειδοποίηση/αποστολή και ειδοποίηση/λίστα.
Κοινές έννοιες
Στόχευση για κινητά
Οι ειδοποιήσεις αποστέλλονται σε μια συγκεκριμένη κινητή συσκευή χρησιμοποιώντας πλευράΤο τελικό σημείο της λίστας μπορεί να φιλτράρει τον ίδιο στόχο χρησιμοποιώντας προσδιοριστής ή πλευρά.
Κατανεμημένη κατάσταση
- διανεμημένο=1 σημαίνει ότι η ειδοποίηση διανεμήθηκε.
- διανεμημένο=0 σημαίνει ότι δεν διανέμεται.
- κατανεμημένη_κατάσταση επιστρέφει διανεμημένο ή δεν_διανέμεται.
Ημερομηνίες και ζώνες ώρας
- απεστάλη_* Τα πεδία αντιπροσωπεύουν την ημερομηνία/ώρα αποστολής της ειδοποίησης GMT.
- κατανεμημένο_* Τα πεδία αντιπροσωπεύουν την ημερομηνία/ώρα διανομής στο GMT.
- *_at_unix Τα πεδία είναι χρονικές σημάνσεις Unix.
Συμπεριφορά τελικού σημείου λίστας
- Το τελικό σημείο της λίστας επιστρέφει πάντα το μέγιστο 200 σειρές.
- Τα αποτελέσματα ταξινομούνται από το νεότερο στο παλαιότερο χρησιμοποιώντας την ημερομηνία/ώρα αποστολής.
- Χρήση φίλτρων ημερομηνίας dateAjout εσωτερικά και εκτίθενται ως ημερομηνία_από / ημερομηνία_έως.
Σφάλματα
| HTTP | Παράδειγμα σφάλματος | Εννοια |
|---|---|---|
| 400 | {"success":false,"message":"Λείπει η απαιτούμενη παράμετρος: apikey."} | Λείπει ή είναι κενό apikey. |
| 400 | {"success":false,"message":"Λείπουν οι απαιτούμενες παράμετροι: οι παράμετροι apikey και sid είναι υποχρεωτικές."} | Απών πλευρά επί ειδοποίηση/αποστολή. |
| 400 | {"success":false,"message":"Λείπει η απαιτούμενη παράμετρος: message."} | Απών μήνυμα επί ειδοποίηση/αποστολή. |
| 400 | {"success":false,"message":"Μη έγκυρη μορφή date_from. Αναμενόταν ΕΕΕΕ-ΜΜ-ΗΗ."} | Ακυρος ημερομηνία_από μορφή σε ειδοποίηση/λίστα. |
| 400 | {"success":false,"message":"Μη έγκυρη κατανεμημένη τιμή. Επιτρεπόμενες τιμές: 0 ή 1."} | Ακυρος διανεμημένο τιμή φίλτρου. |
| 500 | {"επιτυχία":false,"message":"Η σύνδεση στη βάση δεδομένων απέτυχε."} | Πρόβλημα σύνδεσης με βάση δεδομένων. |
| 500 | {"επιτυχία":false,"message":"Το ερώτημα απέτυχε: ..."} | Σφάλμα SQL / εκτέλεσης. |
Ειδοποίηση – Αποστολή
Δημιουργήστε μια νέα ειδοποίηση για μια κινητή συσκευή-στόχο.
Τελικό σημείο
ΠΑΙΡΝΩ
ΘΕΣΗ
https://api.smsmobileapi.com/notification/send
Παράμετροι ερωτήματος / σώματος
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| apikey | σειρά | Υποχρεούμαι Το κλειδί API σας. |
| πλευρά | σειρά | Υποχρεούμαι Προσδιοριστής στόχευσης για κινητά. |
| τίτλος | σειρά | Προαιρετικός Τίτλος ειδοποίησης. Προεπιλογή: Κοινοποίηση. |
| μήνυμα | σειρά | Υποχρεούμαι Περιεχόμενο μηνύματος ειδοποίησης. |
| τύπος | σειρά | Προαιρετικός Τύπος ειδοποίησης. Προεπιλογή: κοινοποίηση. |
Παράδειγμα απόκρισης επιτυχίας
{ "επιτυχία": true, "μήνυμα": "Η ειδοποίηση δημιουργήθηκε.", "id": 22087, "apikey": "ΤΟ ΚΛΕΙΔΙ_YOUR_API", "sid": "508b004b4aadacc4" }
Ειδοποίηση – Λίστα
Ανάκτηση των πιο πρόσφατων ειδοποιήσεων για ένα κλειδί API, με προαιρετικό φιλτράρισμα.
Τελικό σημείο
ΠΑΙΡΝΩ
https://api.smsmobileapi.com/notification/list/
Παράμετροι ερωτήματος
| Παράμετρος | Τύπος | Περιγραφή |
|---|---|---|
| apikey | σειρά | Υποχρεούμαι Το κλειδί API σας. |
| προσδιοριστής | σειρά | Προαιρετικός Φιλτράρισμα ειδοποιήσεων ανά κινητό στόχο. |
| πλευρά | σειρά | Προαιρετικός Ψευδώνυμο του προσδιοριστής. |
| διανεμημένο | 0 | 1 | Προαιρετικός 1 = διανέμεται μόνο, 0 = δεν διανέμεται μόνο. |
| ημερομηνία_από | ΕΕΕΕ-ΜΜ-ΗΗ | Προαιρετικός Φιλτράρισμα ημερομηνίας αποστολής από αυτήν την ημέρα. |
| ημερομηνία_έως | ΕΕΕΕ-ΜΜ-ΗΗ | Προαιρετικός Φίλτρο με ημερομηνία αποστολής έως σήμερα. |
Το τελικό σημείο της λίστας επιστρέφει το πολύ 200 σειρές και τις ταξινομεί με βάση την πιο πρόσφατη ειδοποίηση που στάλθηκε πρώτα.
Παράδειγμα απόκρισης επιτυχίας
{ "επιτυχία": true, "μήνυμα": "Οι ειδοποιήσεις ανακτήθηκαν με επιτυχία.", "φίλτρα": { "sidentifiant": "508b004b4aadacc4", "διανεμημένο": "1", "date_from": "", "date_to": "", "όριο": 200 }, "count": 1, "δεδομένα": [ { "sidentifiant": "508b004b4aadacc4", "title": "Ειδοποίηση", "μήνυμα": "έκδοση 1", "διανεμημένο": "1", "distribued_status": "διανεμημένο", "distributed_date_gmt": "2026-03-18", "distributed_time_gmt": "10:18:30", "distributed_at_gmt": "2026-03-18 10:18:30", "distributed_at_gmt": "2026-03-18 10:18:30", "distributed_at_unix": 1773829110, "distributed_timezone": "GMT", "sent_date_gmt": "2026-03-18", "sent_time_gmt": "10:15:03", "sent_at_gmt": "2026-03-18 10:15:03", "sent_at_unix": 1773828903, "sent_timezone": "GMT" } ] }
Αποστολή πεδίων απάντησης
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| επιτυχία | βουλ | Κατάσταση αιτήματος. |
| μήνυμα | σειρά | Μήνυμα αποτελέσματος αναγνώσιμο από τον άνθρωπο. |
| ταυτότητα | εσωτ. | Δημιουργήθηκε αναγνωριστικό ειδοποίησης στη βάση δεδομένων. |
| apikey | σειρά | Κλειδί API με επανάληψη. |
| πλευρά | σειρά | Αναγνωριστικό στόχου για κινητά που χρησιμοποιήθηκε κατά τη δημιουργία. |
Λίστα πεδίων απόκρισης
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
| επιτυχία | βουλ | Κατάσταση αιτήματος. |
| μήνυμα | σειρά | Μήνυμα αποτελέσματος αναγνώσιμο από τον άνθρωπο. |
| φίλτρα | αντικείμενο | Φίλτρα με ηχώ που χρησιμοποιούνται από το αίτημα. |
| κόμης | εσωτ. | Αριθμός επιστρεφόμενων ειδοποιήσεων. |
| δεδομένα | παράταξη | Λίστα ειδοποιήσεων. |
| δεδομένα[].αναγνωριστικό | σειρά | Αναγνωριστικό κινητού στόχου. |
| δεδομένα[].τίτλος | σειρά | Τίτλος ειδοποίησης. |
| δεδομένα[].μήνυμα | σειρά | Μήνυμα ειδοποίησης. |
| δεδομένα[].διανεμημένα | σειρά | Ακατέργαστη κατανεμημένη σημαία. |
| δεδομένα[].κατανεμημένη_κατάσταση | σειρά | διανεμημένο ή δεν_διανέμεται. |
| δεδομένα[].distributed_date_gmt | σειρά | Ημερομηνία διανομής σε GMT. |
| δεδομένα[].distributed_time_gmt | σειρά | Ώρα διανομής σε GMT. |
| δεδομένα[].distributed_at_gmt | σειρά | Πλήρης ημερομηνία/ώρα διανομής σε GMT. |
| δεδομένα[].distributed_at_unix | int|null | Ημερομηνία/ώρα διανομής ως χρονική σήμανση Unix. |
| δεδομένα[].διανεμημένη_ζώνη_ώρας | σειρά | Πάντοτε GMT. |
| δεδομένα[].sent_date_gmt | σειρά | Αποστολή ημερομηνίας σε GMT. |
| δεδομένα[].sent_time_gmt | σειρά | Αποστολή ώρας σε GMT. |
| δεδομένα[].sent_at_gmt | σειρά | Πλήρης ημερομηνία/ώρα αποστολής σε GMT. |
| δεδομένα[].sent_at_unix | int|null | Αποστολή ημερομηνίας/ώρας ως χρονικής σήμανσης Unix. |
| δεδομένα[].sent_timezone | σειρά | Πάντοτε GMT. |
English 
French 
German 
Spanish 
Portuguese 
Russian 
Finnish 
Japanese 
Chinese 
Vietnamese 
Dutch 
Greek 
Arabic 
Danish 
Italian 
Ukrainian