Τεκμηρίωση SMS

Στην SMSmobileAPI, προσπαθούμε να κάνουμε το API μας όσο το δυνατόν πιο συμβατό με οποιαδήποτε αρχιτεκτονική ή πλατφόρμα.
Είτε χρησιμοποιείτε REST, SOAP, cURL είτε διάφορες γλώσσες προγραμματισμού όπως Python, JavaScript, PHP και άλλες, το API μας έχει σχεδιαστεί για να ενσωματώνεται απρόσκοπτα στα έργα σας.

Έχουμε επίσης έτοιμα προς χρήση πρόσθετα για λύσεις και λογισμικό ηλεκτρονικού εμπορίου.
Κάντε κλικ εδώ για να τα ανακαλύψετε.

Χρειάζεστε βοήθεια; api@smsmobileapi.com

Ερευνα

Αποστολή SMS

Αυτό το τελικό σημείο σάς επιτρέπει να στέλνετε ένα SMS από το κινητό σας τηλέφωνο.

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

ΠΑΙΡΝΩ ΘΕΣΗ https://api.smsmobileapi.com/sendsms/

Παράμετροι:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το μοναδικό κλειδί API σας.
recipients	Υποχρεούμαι Ο αριθμός τηλεφώνου του παραλήπτη.
message	Υποχρεούμαι Το μήνυμα προς αποστολή (χωρίς όριο 160 χαρακτήρων).
port	Ορίστε τη θύρα SIM που θα χρησιμοποιηθεί για την αποστολή του SMS: 1, 2ή αφήστε το κενό. Εάν αφήσετε κενό, το SMS θα αποσταλεί αυτόματα χρησιμοποιώντας την διαθέσιμη θύρα SIM. Αυτή η παράμετρος είναι διαθέσιμη από την έκδοση Android 4.1.15.0 και λειτουργεί όταν η εφαρμογή βρίσκεται σε προσκήνιο (πρώτο σχέδιο).
shorturl	1 = μετατροπή URL σε σύντομους συνδέσμους 0 ή κενό = καμία μετατροπή
sIdentifiant	Επιλέξτε ποιο συνδεδεμένο τηλέφωνο στέλνει το SMS. Αφήστε κενό για την πρώτη διαθέσιμη συσκευή. Απαιτείται η εφαρμογή 3.0.35.3+.
sendwa	1 = αποστολή μέσω WhatsApp.
sendsms	1 = αποστολή μέσω SMS (προεπιλογή εάν είναι κενό). Ορίστε σε 0 για αποκλεισμό SMS.
encrypt_message	Ναί = ο παραλήπτης χρειάζεται ένα κλειδί για την αποκρυπτογράφηση. Μάθετε περισσότερα
schedule_timestamp	Χρονική σήμανση UNIX (GMT 0) από την οποία θα πρέπει να αποσταλεί το SMS.

Παράδειγμα:

ΑΠΟΚΤΗΣΤΕ https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld

Σημείωση: σε περίπτωση σφάλματος παράδοσης που προκαλείται από τον χειριστή σας, μια προεπιλεγμένη λειτουργία επαναλαμβάνει έως και 3 φορές.

Στείλτε ξανά ένα μη απεσταλμένο SMS

Αυτό το τελικό σημείο API χρησιμοποιείται για την εκ νέου αποστολή ενός μη απεσταλμένου SMS (μόνο εάν το μήνυμα έχει κατάσταση σφάλματος).

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

ΠΑΙΡΝΩ ΘΕΣΗ https://api.smsmobileapi.com/resend/

Παράμετρος:

Παράμετρος	Περιγραφή
guid	Υποχρεούμαι GUID του μηνύματος που θα σταλεί εκ νέου.

Παράδειγμα:

ΛΑΒΕ https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE

Αρχείο καταγραφής SMS που αποστέλλονται από το API

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

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

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

Παράμετρος:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το κλειδί API σας.
guid_message	Φιλτράρετε με βάση το μοναδικό αναγνωριστικό του μηνύματος.
before	Ανάκτηση μηνυμάτων που στάλθηκαν πριν από αυτήν τη χρονική σήμανση ή το GUID.
error_api	1 = λίστα SMS με σφάλμα αιτήματος API.
error_mobile	1 = λίστα SMS με σφάλμα επεξεργασίας κινητού.
keyword	Φιλτράρισμα κατά αριθμό παραλήπτη ή περιεχόμενο μηνύματος.

Παράδειγμα:

ΛΑΒΕ https://api.smsmobileapi.com/log/sent/sms?apikey=YOUR_API_KEY

Λίστα απεσταλμένων SMS από κινητό

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

Σπουδαίος: Αυτή η λειτουργία είναι διαθέσιμη από την έκδοση Android 4.1.20.

Σπουδαίος: Αυτό το χαρακτηριστικό είναι δεν είναι ενεργοποιημένο από προεπιλογή στην εφαρμογή Android.

Μυστικότητα: Όλες οι συγχρονισμένες πληροφορίες είναι ανώνυμες, εμπιστευτικές και διαχειρίζονται με ασφάλεια.

Όριο ιστορικού: Αυτό το API επιστρέφει πάντα δεδομένα από το τελευταίο 7 ημέρες μόνο.

Σημείωμα: Εάν στέλνετε SMS χρησιμοποιώντας το τυπικό τελικό σημείο API https://api.smsmobileapi.com/sendsms/, αυτά τα SMS ενδέχεται επίσης να εμφανίζονται σε αυτήν την καταχώριση επειδή αποστέλλονται φυσικά από την κινητή σας συσκευή.

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

ΠΑΙΡΝΩ ΘΕΣΗ https://api.smsmobileapi.com/log/sent/frommobile/

Παράμετροι:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το κλειδί API σας.
date	Προαιρετικό. Φίλτρο ακριβούς ημερομηνίας στο YYYY-MM-DD σχήμα και διάταξις βιβλίου.
date_from	Προαιρετικό. Ημερομηνία έναρξης της περιόδου σε YYYY-MM-DD σχήμα και διάταξις βιβλίου.
date_to	Προαιρετικό. Ημερομηνία λήξης της περιόδου σε YYYY-MM-DD σχήμα και διάταξις βιβλίου.
period	Προαιρετικό. Προκαθορισμένο φίλτρο περιόδου. Επιτρεπόμενες τιμές: today, yesterday, last_24h, last_3days, last_7days.
number	Προαιρετικό. Φιλτράρισμα κατά αριθμό τηλεφώνου παραλήπτη.
sIdentifiant	Προαιρετικό. Φιλτράρισμα κατά αναγνωριστικό κινητού.
message	Προαιρετικό. Φιλτράρισμα κατά περιεχόμενο SMS.
search	Προαιρετικό. Παγκόσμια αναζήτηση ενεργοποιημένη sIdentifiant, number, message, mobile_date_formatted, και synchro_time.
sort_by	Προαιρετικό. Πεδίο ταξινόμησης. Επιτρεπόμενες τιμές: sIdentifiant, number, message, mobile_date_ms, mobile_date_formatted, synchro_time.
sort_order	Προαιρετικά. Σειρά ταξινόμησης: ASC ή DESC.
limit	Προαιρετικό. Μέγιστος αριθμός γραμμών που επιστρέφονται. Μέγιστη επιτρεπόμενη τιμή: 200.

Επιστρεφόμενα πεδία:

Πεδίο	Περιγραφή
sIdentifiant	Αναγνωριστικό κινητού που συνδέεται με το απεσταλμένο SMS.
number	Αριθμός τηλεφώνου παραλήπτη.
message	Περιεχόμενο SMS.
mobile_date_ms	Αρχική χρονική σήμανση SMS σε χιλιοστά του δευτερολέπτου.
mobile_date_formatted	Μορφοποιημένη ημερομηνία που ελήφθη από την κινητή συσκευή.
synchro_time	Ημερομηνία και ώρα συγχρονισμού του SMS με το SMSMobileAPI.

Παράδειγμα:

ΛΗΨΗ https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY

Παράδειγμα με φίλτρα:

ΛΗΨΗ https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&date=2026-03-13&number=32470000000&sort_by=synchro_time&sort_order=DESC

Παράδειγμα με προκαθορισμένη περίοδο:

ΛΗΨΗ https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&period=last_7days&limit=200

Λήφθηκε SMS

Αυτό το τελικό σημείο API χρησιμοποιείται για την ανάκτηση μηνυμάτων SMS που λαμβάνονται στο smartphone.

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

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

Παράμετρος:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το κλειδί API που έχετε ή θα λάβετε.
sIdentifiantPhone	Απομονώστε ένα τηλέφωνο που είναι συνδεδεμένο με το ληφθέν SMS.
after_timestamp_unix	Λίστα ληφθέντων SMS μετά από χρονική σήμανση UNIX.
onlyunread	"ναι" = λίστα μόνο SMS που δεν έχουν επισημανθεί ως αναγνωσμένα (κατάσταση API).

Παράδειγμα:

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

Σήμανση μηνυμάτων SMS που ελήφθησαν ως αναγνωσμένα

Αυτό το τελικό σημείο API χρησιμοποιείται για να επισημάνει ένα ληφθέν μήνυμα SMS ως αναγνωσμένο στο Μόνο κατάσταση API.
Αυτό δεν αλλάζει την κατάσταση ανάγνωσης στο smartphone.

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

ΠΑΙΡΝΩ https://api.smsmobileapi.com/getsms/set-read/

Παράμετρος:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το κλειδί API που έχετε ή θα λάβετε.
guid_message	Υποχρεούμαι GUID του μηνύματος που θα επισημανθεί ως αναγνωσμένο.

Παράδειγμα:

ΛΗΨΗ https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_APIKEY&guid_message=GUID_MESSAGE

Ενημέρωση ψευδωνύμου SMS

Αυτό το τελικό σημείο API χρησιμοποιείται για την ενημέρωση του ψευδωνύμου ενός ληφθέντος SMS χρησιμοποιώντας το GUID του.

Σημείωμα: Ο alias Η παράμετρος μπορεί να είναι κενή. Σε αυτήν την περίπτωση, το ψευδώνυμο θα διαγραφεί.

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

ΠΑΙΡΝΩ ΘΕΣΗ https://api.smsmobileapi.com/getsms/update/

Παράμετροι:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το κλειδί API σας.
guid	Υποχρεούμαι GUID του ληφθέντος SMS προς ενημέρωση.
alias	Υποχρεούμαι Ψευδώνυμο προς αντιστοίχιση σε αυτό το SMS. Αυτή η τιμή μπορεί να είναι κενή για να διαγραφεί το τρέχον ψευδώνυμο.

Παράδειγμα:

ΑΠΟΚΤΗΣΤΕ https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE&alias=JohnDoe

Παράδειγμα για την εκκαθάριση του ψευδωνύμου:

ΑΠΟΚΤΗΣΤΕ https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE&alias=

Διαγραφή SMS

Αυτό το τελικό σημείο API χρησιμοποιείται για τη διαγραφή μηνυμάτων SMS από το αρχείο καταγραφής διακομιστή του SMS Mobile API.

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

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

Παράμετρος:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το κλειδί API που έχετε.
guid_message	Το μοναδικό αναγνωριστικό του μηνύματος προς διαγραφή.
date_start	Εάν χρησιμοποιείται μόνο του, διαγράφει όλα τα μηνύματα από την καθορισμένη ημέρα.
date_start and date_end	Συνδυάζεται για τη διαγραφή μηνυμάτων εντός μιας καθορισμένης περιόδου.

Παράδειγμα:

ΛΑΒΕ https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY

Σημείωση: Τα διαγραμμένα SMS είναι μόνο όσα είναι αποθηκευμένα στα αρχεία καταγραφής του διακομιστή. Τα SMS στη συσκευή δεν θα διαγραφούν.

Λίστα συνομιλιών SMS

Αυτό το τελικό σημείο API χρησιμοποιείται για την καταγραφή συνομιλιών SMS που συνδέονται με τον λογαριασμό σας.

Κάθε συνομιλία ομαδοποιείται κατά αριθμό τηλεφώνου και περιέχει τα σχετικά εισερχόμενα και εξερχόμενα μηνύματα SMS.

Σημείωμα: Το σημείο έναρξης της συζήτησης ορίζεται από το origineConversation παράμετρος:

received: οι συνομιλίες ανιχνεύονται πρώτα από τα ληφθέντα SMS στο logsmsreceive
sent: οι συνομιλίες ανιχνεύονται για πρώτη φορά από τα απεσταλμένα SMS στο logsmssent

Σημείωμα: Αν numero δεν παρέχεται, το API επιστρέφει μόνο τις πιο πρόσφατες συνομιλίες. Από προεπιλογή, η τελευταία 20 Οι συνομιλίες επιστρέφονται.

Σημείωμα: Για εξερχόμενα SMS, εάν timearea_of_message είναι διαθέσιμο (παράδειγμα: UTC+02), η εμφανιζόμενη ημερομηνία μετατρέπεται αυτόματα χρησιμοποιώντας αυτήν την τιμή. Αυτή η ημερομηνία μετατροπής χρησιμοποιείται επίσης για ταξινόμηση.

Σημείωμα: Αν resume=1, επιστρέφονται μόνο τα πιο πρόσφατα μηνύματα κάθε συνομιλίας. Χρησιμοποιήστε resume_line_how για να ορίσετε πόσα πιο πρόσφατα μηνύματα θα πρέπει να συμπεριληφθούν.

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

ΠΑΙΡΝΩ ΘΕΣΗ https://api.smsmobileapi.com/conversation/sms/list/

Παράμετροι:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το κλειδί API σας.
origineConversation	Υποχρεούμαι Ορίζει το σημείο έναρξης της καταχώρισης συνομιλίας. Επιτρεπόμενες τιμές: received ή sent.
numero	Προαιρετικός Φιλτράρετε το αποτέλεσμα μόνο για έναν συγκεκριμένο αριθμό τηλεφώνου.
date_from	Προαιρετικός Φίλτρο ημερομηνίας έναρξης για συνομιλίες και μηνύματα. Αποδεκτή μορφή: YYYY-MM-DD ή μια πλήρης τιμή ημερομηνίας/ώρας.
date_to	Προαιρετικός Φίλτρο ημερομηνίας λήξης για συνομιλίες και μηνύματα. Αποδεκτή μορφή: YYYY-MM-DD ή μια πλήρης τιμή ημερομηνίας/ώρας.
sort	Προαιρετικός Σειρά ταξινόμησης για συνομιλίες. Επιτρεπόμενες τιμές: DESC ή ASCΠροεπιλογή: DESC.
limit	Προαιρετικός Μέγιστος αριθμός συνομιλιών που θα επιστραφούν όταν numero δεν παρέχεται. Προεπιλογή: 20.
resume	Προαιρετικός Εάν έχει οριστεί σε 1, επιστρέφονται μόνο τα πιο πρόσφατα μηνύματα κάθε συνομιλίας.
resume_line_how	Προαιρετικός Αριθμός τελευταίων μηνυμάτων που θα επιστραφούν ανά συνομιλία όταν resume=1Προεπιλογή: 1.

Λεπτομέρειες συμπεριφοράς:

Τα εισερχόμενα SMS διαβάζονται από logsmsreceive.
Τα εξερχόμενα SMS διαβάζονται από logsmssent.
Τα εισερχόμενα μηνύματα επιστρέφουν πάντα direction = "incoming".
Τα εξερχόμενα μηνύματα επιστρέφουν πάντα direction = "outgoing".
Το ψευδώνυμο επαφής προέρχεται από logsmsreceive.alias όταν είναι διαθέσιμο.
Για τα εισερχόμενα SMS, το SID του κινητού προέρχεται από sIdentifiant_pour_read.
Για τα εξερχόμενα SMS, το SID του κινητού προέρχεται από send_from_mobile_sIdentifiant.
Για τα εξερχόμενα SMS, η εμφανιζόμενη ημερομηνία προσαρμόζεται με timearea_of_message εάν αυτό το πεδίο δεν είναι κενό.

Παράδειγμα 1 - Λίστα των τελευταίων συνομιλιών από τα SMS που λάβατε:

ΛΗΨΗ https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received

Παράδειγμα 2 - Λίστα των τελευταίων συνομιλιών από τα απεσταλμένα SMS:

ΛΗΨΗ https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=sent

Παράδειγμα 3 - Φιλτράρισμα ενός συγκεκριμένου αριθμού τηλεφώνου:

ΛΗΨΗ https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&numero=32470000001

Παράδειγμα 4 - Φιλτράρισμα κατά εύρος ημερομηνιών:

ΛΗΨΗ https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&date_from=2026-03-01&date_to=2026-03-31

Παράδειγμα 5 - Λειτουργία συνέχισης με τα τελευταία 3 μηνύματα ανά συνομιλία:

ΛΗΨΗ https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=sent&resume=1&resume_line_how=3

Παράδειγμα επιτυχημένης απάντησης:

{ "επιτυχία": true, "origineConversation": "received", "resume": 0, "resume_line_how": null, "conversations": [ { "phone_number": "+10470000001", "contact_alias": "John Doe", "messages": [ { "direction": "incoming", "message_id": "msg_1001", "date": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "message": "Γεια σας, θα ήθελα περισσότερες πληροφορίες.", "status": "received", "mobile_sid": "device_sid_1" }, { "direction": "outgoing", "message_id": "msg_1002", "date": "2026-03-13 10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "Φυσικά, τι θα θέλατε να μάθετε;", "status": "απεστάλη", "mobile_sid": "device_sid_2" } ] } ] }

Πεδία απόκρισης:

Πεδίο	Περιγραφή
success	Υποδεικνύει εάν το αίτημα ήταν επιτυχές.
origineConversation	Η λειτουργία έναρξης που χρησιμοποιείται για τη δημιουργία της λίστας συνομιλιών.
resume	Υποδεικνύει εάν η λειτουργία συνέχισης είναι ενεργοποιημένη.
resume_line_how	Αριθμός τελευταίων γραμμών που επιστρέφονται ανά συνομιλία όταν είναι ενεργοποιημένη η λειτουργία συνέχισης.
conversations	Ποικιλία συνομιλιών.
phone_number	Αριθμός τηλεφώνου που χρησιμοποιείται για την αναγνώριση της συνομιλίας.
contact_alias	Ψευδώνυμο που συνδέεται με τον αριθμό τηλεφώνου, όταν είναι διαθέσιμο.
messages	Μια σειρά από μηνύματα SMS μέσα στη συνομιλία.
direction	incoming για τα ληφθέντα SMS, outgoing για τα απεσταλμένα SMS.
message_id	Μοναδικό αναγνωριστικό του μηνύματος.
date	Εμφάνιση ημερομηνίας του μηνύματος. Για εξερχόμενα SMS, αυτή η τιμή μπορεί να προσαρμοστεί χρησιμοποιώντας timearea_of_message.
timestamp_utc	Χρονική σήμανση UTC του μηνύματος.
message	Περιεχόμενο μηνύματος.
status	received για εισερχόμενα SMS, sent για εξερχόμενα SMS.
mobile_sid	SID της κινητής συσκευής που έλαβε ή έστειλε το μήνυμα.

Παράδειγμα σφάλματος:

{ "επιτυχία": false, "σφάλμα": "Λείπει η απαιτούμενη παράμετρος: apikey" }

Σημειώσεις:

Αν numero παρέχεται, το API επιστρέφει μόνο τη συνομιλία που είναι συνδεδεμένη με αυτόν τον αριθμό τηλεφώνου.
Αν numero Εάν δεν παρέχεται, το API επιστρέφει τις πιο πρόσφατες συνομιλίες σύμφωνα με την επιλεγμένη λειτουργία προέλευσης.
Τα εισερχόμενα και εξερχόμενα μηνύματα συγχωνεύονται σε μία ενιαία χρονογραμμή για κάθε αριθμό τηλεφώνου.
Η ταξινόμηση εξερχόμενων μηνυμάτων λαμβάνει υπόψη την προσαρμοσμένη τοπική ημερομηνία όταν timearea_of_message είναι διαθέσιμο.
Η λειτουργία συνέχισης είναι χρήσιμη για πίνακες ελέγχου, γραφικά στοιχεία, προεπισκοπήσεις και συνόψεις συνομιλιών.

Πύλη – Λίστα συνδεδεμένων κινητών τηλεφώνων

Λίστα κινητών τηλεφώνων που είναι συνδεδεμένα με το SMS Gateway.

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

ΠΑΙΡΝΩ ΘΕΣΗ https://api.smsmobileapi.com/gateway/mobile/list/

Παράμετροι:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το κλειδί API σας.
sid	Φιλτράρισμα κατά ακριβές SID (sIdentifiant_pour_check).
search	Αναζήτηση σε πεδία (όνομα sid, ημερομηνία, μπαταρία, έκδοση, ετικέτα...).

Παράδειγμα:

ΛΗΨΗ https://api.smsmobileapi.com/gateway/mobile/list/?apikey=YOUR_API_KEY

Σημείωση: Τα στατιστικά στοιχεία για τα ληφθέντα SMS είναι διαθέσιμα από την έκδοση 3.0.33.3+ της εφαρμογής για κινητά.

Πύλη – Ενημέρωση ετικέτας για κινητά

Ενημερώστε την ετικέτα (nom_reference) ενός συνδεδεμένου κινητού.

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

ΠΑΙΡΝΩ ΘΕΣΗ https://api.smsmobileapi.com/gateway/mobile/update/

Παράμετροι:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το κλειδί API σας.
sid	Υποχρεούμαι Το SID της συσκευής (sIdentifiant_pour_check).
label	Νέα ετικέτα
phone_number	Νέος αριθμός τηλεφώνου

Παράδειγμα:

ΛΗΨΗ https://api.smsmobileapi.com/gateway/mobile/update/?apikey=YOUR_API_KEY&sid=SID&label=OfficePhone

Σπουδαίος: Η ετικέτα είναι απαραίτητη αλλά μπορεί να είναι κενή (ετικέτα=).

Πύλη – Διαγραφή συνδεδεμένου κινητού

Αφαιρέστε ένα συνδεδεμένο κινητό από την πύλη σας (διαγράφει όλες τις γραμμές ιστορικού για αυτό το SID).

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

ΠΑΙΡΝΩ ΘΕΣΗ https://api.smsmobileapi.com/gateway/mobile/delete/

Παράμετροι:

Παράμετρος	Περιγραφή
apikey	Υποχρεούμαι Το κλειδί API σας.
sid	Υποχρεούμαι Το SID της συσκευής (sIdentifiant_pour_check).

Παράδειγμα:

ΛΗΨΗ https://api.smsmobileapi.com/gateway/mobile/delete/?apikey=YOUR_API_KEY&sid=SID

Webhook – Λήφθηκε SMS

Αυτό το σύστημα webhook στέλνει ένα αίτημα POST στη διαμορφωμένη διεύθυνση URL κάθε φορά που λαμβάνεται ένα SMS. Το σύστημα διασφαλίζει ενημερώσεις σε πραγματικό χρόνο, παραδίδοντας τις λεπτομέρειες SMS στην καθορισμένη διεύθυνση URL του webhook.

Τρόπος διαμόρφωσης του Webhook στον πίνακα ελέγχου

Ακολουθήστε αυτά τα βήματα για να ρυθμίσετε τη διεύθυνση URL του webhook στον πίνακα ελέγχου:

Συνδεθείτε στον λογαριασμό σας στο SMS Mobile API Dashboard.
Πλοηγηθείτε στο Ρυθμίσεις Webhook τμήμα.
Εισαγάγετε τη διεύθυνση URL του webhook σας (π.χ. https://example.com/webhook-endpoint).
Κάντε κλικ στο Αποθήκευση Webhook κουμπί.
Μόλις αποθηκευτεί, το σύστημα θα αρχίσει να στέλνει λεπτομέρειες SMS στη διαμορφωμένη διεύθυνση URL.

Webhook Payload

Όταν λαμβάνεται ένα SMS, το σύστημα στέλνει το ακόλουθο ωφέλιμο φορτίο JSON στη διεύθυνση URL του webhook σας:

{ "ημερομηνία": "2025-01-20", "ώρα": "10:15:00", "ώρα_λήψης": "2025-01-20 10:14:50", "μήνυμα": "Γεια σας, αυτή είναι μια δοκιμή.", "αριθμός": "+123456789", "guid": "abcde12345" }

Πεδία ωφέλιμου φορτίου:

ημερομηνία: Ημερομηνία προσθήκης του SMS (ΕΕΕΕ-ΜΜ-ΗΗ).
ώρα: Ώρα κατά την προσθήκη του SMS (ΩΩ:λλ:δδ).
time_received: Ώρα λήψης του SMS.
μήνυμα: Το περιεχόμενο του SMS.
αριθμός: Αριθμός τηλεφώνου αποστολέα.
οδηγός: Μοναδικό αναγνωριστικό του SMS.

Παράδειγμα Webhook Endpoint

Ο διακομιστής σας θα πρέπει να είναι έτοιμος να χειριστεί εισερχόμενα αιτήματα POST. Ακολουθεί ένα παράδειγμα σεναρίου PHP για την επεξεργασία του ωφέλιμου φορτίου webhook:

Δοκιμή του Webhook

Για να δοκιμάσετε τη διαμόρφωση του webhook, χρησιμοποιήστε εργαλεία όπως:

Αντιμετώπιση προβλημάτων

Βεβαιωθείτε ότι η διεύθυνση URL του webhook είναι σωστή και προσβάσιμη στο κοινό.
Βεβαιωθείτε ότι ο διακομιστής σας επιστρέφει έναν κωδικό κατάστασης HTTP 200 για επιτυχημένα αιτήματα.
Ελέγξτε τα αρχεία καταγραφής του διακομιστή σας για τυχόν σφάλματα κατά την επεξεργασία του ωφέλιμου φορτίου.

Εμπλουτισμένα SMS

Προσεχώς

Πιστοποίηση

Το SMSMobile API υποστηρίζει δύο μεθόδους ελέγχου ταυτότητας: χρησιμοποιώντας ένα απλό κλειδί API ή το πρωτόκολλο OAuth2 με αναγνωριστικό πελάτη και μυστικό πελάτη.

1. Έλεγχος ταυτότητας κλειδιού API

Αυτή η μέθοδος απαιτεί ένα κλειδί API που μπορεί να συμπεριληφθεί ως παράμετρος είτε σε ένα αίτημα GET είτε σε ένα αίτημα POST.

2. Έλεγχος ταυτότητας OAuth2

Το OAuth2 παρέχει μια πιο ασφαλή μέθοδο ελέγχου ταυτότητας.
Χρησιμοποιήστε ένα αναγνωριστικό πελάτη και ένα μυστικό κλειδί πελάτη για να λάβετε ένα διακριτικό πρόσβασης και, στη συνέχεια, συμπεριλάβετε το στο Εξουσιοδότηση επί κεφαλής.

Το client_id και το client_secret είναι διαθέσιμα στον πίνακα ελέγχου σας.
Κατεβάστε την εφαρμογή για κινητά τώρα ή πρόσβαση στον πίνακα ελέγχου σας.

Λήψη διακριτικού πρόσβασης


curl -X POST https://api.smsmobileapi.com/oauth2/token \

-H "Content-Type: application/x-www-form-urlencoded" \

-d "grant_type=client_credentials" \

-d "client_id=YOUR_CLIENT_ID" \

-d "client_secret=YOUR_CLIENT_SECRET"

Χρήση του Access Token:


curl -X POST https://api.smsmobileapi.com/sendsms \

-H "Εξουσιοδότηση: Φορέας YOUR_ACCESS_TOKEN" \

-H "Content-Type: application/x-www-form-urlencoded" \

-d "recipients=+1234567890" \

-d "message=Hello"

Ποια μέθοδο πρέπει να χρησιμοποιήσετε;

- Χρήση Έλεγχος ταυτότητας κλειδιού API για γρήγορες και άμεσες ενσωματώσεις.

- Χρήση Έλεγχος ταυτότητας OAuth2 για βελτιωμένη ασφάλεια και επεκτασιμότητα.

Αποστολή SMS

URL WSDL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

Παράμετροι:

- recipients: Ο αριθμός κινητού τηλεφώνου του παραλήπτη.
- message: Το μήνυμα που πρέπει να στείλετε.
- apikey: Το κλειδί API που έχετε ή θα λάβετε.

Παράδειγμα


require_once "lib/nusoap.php";


$client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

$error  = $client->getError();


$result = $client->call("sendSms", array("recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));


print_r($result);

Στείλτε SMS & WhatsApp

Βασική εντολή cURL


curl -X POST https://api.smsmobileapi.com/sendsms/ \

-d "recipients=PHONE_NUMBER" \

-d "message=YOUR_MESSAGE" \

-d "apikey=YOUR_API_KEY" 

-d "sendwa=1"

-d "sendsms=1"

Στείλτε SMS & WhatsApp

Χρησιμοποιήστε την επίσημη ενότητα Python: https://smsmobileapi.com/python/


import requests


url = "https://api.smsmobileapi.com/sendsms/"


payload = {"recipients":"PHONE_NUMBER","message":"YOUR_MESSAGE","apikey":"YOUR_API_KEY"}


response = requests.post(url, data=payload)

print(response.text)

SMS Mobile API - PHP SDK (Συνθέτης)

ο συνθέτης απαιτεί smsmobileapi/sdk

GitHub: https://github.com/SmsMobileApi/smsmobileapi-php/tree/main

Στείλτε SMS & WhatsApp


const url = "https://api.smsmobileapi.com/sendsms/";

const data = {recipients:"PHONE_NUMBER", message:"YOUR_MESSAGE", apikey:"YOUR_API_KEY"};

fetch(url,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams(data)})

.then(r=>r.text()).then(console.log);

Στείλτε SMS & WhatsApp


const axios = require("axios");

axios.post("https://api.smsmobileapi.com/sendsms/", {recipients:"PHONE_NUMBER", message:"YOUR_MESSAGE", apikey:"YOUR_API_KEY"})

.then(r=>console.log(r.data));

Στείλτε SMS & WhatsApp


require "net/http"

require "uri"

uri = URI.parse("https://api.smsmobileapi.com/sendsms/")

req = Net::HTTP::Post.new(uri)

req.set_form_data({"recipients"=>"PHONE_NUMBER","message"=>"YOUR_MESSAGE","apikey"=>"YOUR_API_KEY"})

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true){|http| http.request(req)}

puts res.body

Μπορείτε να στείλετε μηνύματα WhatsApp μόνο μέσω του API μας. Κάντε κλικ εδώ για να μάθετε περισσότερα.

Εάν έχετε οποιεσδήποτε ερωτήσεις, προτάσεις ή χρειάζεστε βοήθεια, η ομάδα μας είναι εδώ για να σας βοηθήσει.
Μη διστάσετε να επικοινωνήσετε μαζί μας στο api@smsmobileapi.com

Κάντε κλικ εδώ για να δοκιμάσετε το κλειδί και την υπηρεσία API με την απλή φόρμα

Ανάλογα με την έκδοση του Android που είναι εγκατεστημένη σε ένα κινητό τηλέφωνο, το λειτουργικό σύστημα μπορεί να εμποδίσει τη σωστή λειτουργία της αυτόματης αποστολής και λήψης μηνυμάτων SMS όταν η εφαρμογή SmsMobileApi δεν βρίσκεται στο προσκήνιο.
Αυτό το ζήτημα προκύπτει από μια διαδικασία που επιχειρεί να εκτελεστεί στο παρασκήνιο όταν η εφαρμογή δεν εκκινείται ενεργά. Ωστόσο, λόγω των μέτρων βελτιστοποίησης της μπαταρίας του Android, τα οποία διαφέρουν σε διαφορετικές εκδόσεις, αυτή η διαδικασία παρασκηνίου ενδέχεται να μην ξεκινήσει σωστά. Η βελτιστοποίηση μπαταρίας του Android έχει σχεδιαστεί για να περιορίζει τη δραστηριότητα στο παρασκήνιο των εφαρμογών για τη διατήρηση της διάρκειας ζωής της μπαταρίας, η οποία μπορεί να επηρεάσει ακούσια εφαρμογές που απαιτούν διαδικασίες παρασκηνίου για να λειτουργήσουν σωστά.

Για την αντιμετώπιση αυτού του ζητήματος, οι χρήστες μπορούν να διαμορφώσουν με μη αυτόματο τρόπο τις ρυθμίσεις τους για Android, ώστε να επιτρέπουν στο SmsMobileApi να χρησιμοποιεί πόρους χωρίς περιορισμούς.
Αυτό περιλαμβάνει την προσαρμογή των ρυθμίσεων βελτιστοποίησης μπαταρίας για τη συγκεκριμένη εφαρμογή, δίνοντας ουσιαστικά οδηγίες στο Android ότι το SmsMobileApi επιτρέπεται να εκτελείται στο παρασκήνιο και να χρησιμοποιεί πόρους όπως απαιτείται. Με αυτόν τον τρόπο, η εφαρμογή θα πρέπει να μπορεί να στέλνει και να λαμβάνει αυτόματα μηνύματα SMS ακόμα και όταν δεν είναι η ενεργή εφαρμογή στο προσκήνιο. Αυτή η προσαρμογή διασφαλίζει ότι η απαραίτητη διαδικασία παρασκηνίου μπορεί να λειτουργεί αδιάκοπα, παρακάμπτοντας τις δυνατότητες βελτιστοποίησης της μπαταρίας που διαφορετικά θα μπορούσαν να εμποδίσουν τη σωστή εκτέλεσή της.

Συχνές ερωτήσεις για προγραμματιστές

Πώς να δημιουργήσετε ένα κλειδί API;

Δείγμα Ακορντεόν ΠεριγραφήΓια να δημιουργήσετε ένα κλειδί API, κατεβάστε την εφαρμογή μας στο κινητό σας τηλέφωνο και δημιουργήστε έναν λογαριασμό χωρίς κόστος. Ένα κλειδί API θα δημιουργηθεί αυτόματα και θα συνδεθεί με το κινητό σας τηλέφωνο. Θα λάβετε επίσης ένα email με όλες τις απαραίτητες πληροφορίες. Αυτή η διαδικασία διασφαλίζει ότι μπορείτε γρήγορα και εύκολα να αρχίσετε να χρησιμοποιείτε τις υπηρεσίες μας με ελάχιστη ρύθμιση.

Πού μπορώ να βρω πάντα το κλειδί API μου;

Στην εφαρμογή για κινητά, μεταβείτε στο μενού ΡΥΘΜΙΣΕΙΣ ή ΒΟΗΘΕΙΑ, όπου το κλειδί API είναι ορατό ανά πάσα στιγμή. Αυτό διασφαλίζει ότι μπορείτε να έχετε εύκολη πρόσβαση στο κλειδί API σας όποτε το χρειάζεστε για την ενοποίηση ή τη χρήση των υπηρεσιών μας.

Μπορεί η δημιουργία ενός κλειδιού API να είναι ανώνυμη;

Ναι, δεν απαιτούμε κανένα αποδεικτικό ταυτότητας για τη δημιουργία κλειδιού API. Επομένως, η επικοινωνία μεταξύ του API μας και του κινητού σας τηλεφώνου είναι 100% ανώνυμη. Αυτή η προσέγγιση επιτρέπει στους χρήστες να διατηρούν το απόρρητό τους ενώ χρησιμοποιούν τις υπηρεσίες μας.

Ξεκινήστε με το SMSmobileAPI σήμερα!

Απολαύστε την ελευθερία και την ευελιξία της διαχείρισης των υπηρεσιών SMS σας εν κινήσει. Κατεβάστε την εφαρμογή μας για κινητά τώρα και κάντε το πρώτο βήμα προς την απρόσκοπτη ενσωμάτωση SMS.

Κατεβάστε την Εφαρμογή

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

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

Αποστολή SMS

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

Παράμετροι:

Παράδειγμα:

Στείλτε ξανά ένα μη απεσταλμένο SMS

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

Παράμετρος:

Παράδειγμα:

Αρχείο καταγραφής SMS που αποστέλλονται από το API

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

Παράμετρος:

Παράδειγμα:

Λίστα απεσταλμένων SMS από κινητό

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

Παράμετροι:

Επιστρεφόμενα πεδία:

Παράδειγμα:

Παράδειγμα με φίλτρα:

Παράδειγμα με προκαθορισμένη περίοδο:

Λήφθηκε SMS

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

Παράμετρος:

Παράδειγμα:

Σήμανση μηνυμάτων SMS που ελήφθησαν ως αναγνωσμένα

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

Παράμετρος:

Παράδειγμα:

Ενημέρωση ψευδωνύμου SMS

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

Παράμετροι:

Παράδειγμα:

Παράδειγμα για την εκκαθάριση του ψευδωνύμου:

Διαγραφή SMS

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

Παράμετρος:

Παράδειγμα:

Λίστα συνομιλιών SMS

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

Παράμετροι:

Λεπτομέρειες συμπεριφοράς:

Παράδειγμα 1 - Λίστα των τελευταίων συνομιλιών από τα SMS που λάβατε:

Παράδειγμα 2 - Λίστα των τελευταίων συνομιλιών από τα απεσταλμένα SMS:

Παράδειγμα 3 - Φιλτράρισμα ενός συγκεκριμένου αριθμού τηλεφώνου:

Παράδειγμα 4 - Φιλτράρισμα κατά εύρος ημερομηνιών:

Παράδειγμα 5 - Λειτουργία συνέχισης με τα τελευταία 3 μηνύματα ανά συνομιλία:

Παράδειγμα επιτυχημένης απάντησης:

Πεδία απόκρισης:

Παράδειγμα σφάλματος:

Σημειώσεις:

Πύλη – Λίστα συνδεδεμένων κινητών τηλεφώνων

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

Παράμετροι:

Παράδειγμα:

Πύλη – Ενημέρωση ετικέτας για κινητά

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

Παράμετροι:

Παράδειγμα:

Πύλη – Διαγραφή συνδεδεμένου κινητού

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

Παράμετροι:

Παράδειγμα:

Webhook – Λήφθηκε SMS

Τρόπος διαμόρφωσης του Webhook στον πίνακα ελέγχου

Webhook Payload

Πεδία ωφέλιμου φορτίου:

Παράδειγμα Webhook Endpoint

Δοκιμή του Webhook

Αντιμετώπιση προβλημάτων

Εμπλουτισμένα SMS

Πιστοποίηση

1. Έλεγχος ταυτότητας κλειδιού API

2. Έλεγχος ταυτότητας OAuth2

Λήψη διακριτικού πρόσβασης

Χρήση του Access Token:

Ποια μέθοδο πρέπει να χρησιμοποιήσετε;

Αποστολή SMS

URL WSDL

Παράμετροι: