Τεκμηρίωση SMS

Αποστολή SMS

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

Παράμετροι:

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

Παράδειγμα απόκρισης JSON:

{ "αποτέλεσμα": { "σφάλμα": 0, "απεστάλη": "1", "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "σημείωση": "απεστάλη από κινητό", "ημερομηνία/ώρα": "2026-03-20T21:07:44Z", "ημερομηνία/τοπική ημερομηνία": "2026-03-20T22:07:44+01:00", "θύρα": null, "iac_control": "1", "iac_authorized": "1", "send_with_whatsapp": "0", "κρυπτογραφημένο": { "κατάσταση": "0" }, "δοκιμαστικός_λογαριασμός": { "κατάσταση": "0", "sms_sent": 0 } } }

Εξήγηση απάντησης:

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

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

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

Παράμετροι: 

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

Παράδειγμα απόκρισης JSON:

{ "αποτέλεσμα": { "σφάλμα": "0", "sms": "επιτυχής αποστολή", "προσπάθεια": 1 } }

Εξήγηση απάντησης:

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

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

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

Παράμετροι:

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

Παράδειγμα απόκρισης JSON:

{ "αποτέλεσμα": { "σφάλμα": "0", "sms": [ { "sIdentifiantPhone": "abbg00055x5", "θύρα": 0, "date_add": "2026-03-20", "hour_add": "22:07:44", "χρονική σήμανση": 1774044464, "send_from_mobile": 1, "send_from_mobile_date": "2026-03-20", "send_from_mobile_heure": "22:10:05", "send_from_mobile_timestamp": 1774044605, "παραλήπτες": "32495898697", "sms": "δοκιμή", "error_api": "", "send_from_mobile_erreur": "", "guid_message": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "ώρα": "UTC+01", "date_add_server": "2026-03-20", "hour_add_server": "21:07:44", "timestamp_server": 1774040864, "send_from_mobile_date_server": "2026-03-20", "send_from_mobile_heure_server": "21:10:05" } ] } }

Εξήγηση απάντησης:

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

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

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

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

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

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

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

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

Παράμετροι: 

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

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

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

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

Παράδειγμα απόκρισης JSON:

{ "result": { "error": "0", "count": 200, "limit": 200, "history_limit_days": 7, "sort_by": "mobile_date_ms", "sort_order": "DESC", "sms": [ { "sIdentifiant": "508b004b4aadacc4", "number": "+15551234567", "message": "Γεια σας, το ραντεβού σας έχει επιβεβαιωθεί.", "mobile_date_ms": 1774041004692, "mobile_date_formatted": "2026-03-20 22:10:04", "synchro_time": "2026-03-20 21:10:05" }, { "sIdentifiant": "e5b70a8a28b2ec3d", "number": "+447700900123", "μήνυμα": "Ο κωδικός επαλήθευσής σας είναι 482915.", "mobile_date_ms": 1774040902284, "mobile_date_formatted": "2026-03-20 22:08:22", "synchro_time": "2026-03-20 21:08:35" }, { "sIdentifiant": "e5b70a8a28b2ec3d", "αριθμός": "+33198765432", "μήνυμα": "Σας ευχαριστούμε για την παραγγελία σας. Αυτή τη στιγμή βρίσκεται υπό επεξεργασία.", "mobile_date_ms": 1774026491230, "mobile_date_formatted": "2026-03-20 18:08:11", "synchro_time": "2026-03-20 17:19:19" } ] } }

Εξήγηση απάντησης:

Λήφθηκε SMS

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

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

Παράμετροι: 

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

Παράδειγμα απόκρισης JSON:

{ "result": { "error": "", "sms": [ { "id": 466340, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320222332804", "indice": "27593", "message": "Γεια σας, το δέμα σας έχει παραδοθεί.", "number": "+15551234567", "guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466341, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320221005892", "indice": "27591", "message": "Το ραντεβού σας για αύριο επιβεβαιώθηκε.", "number": "+447700900123", "guid": "BF3B38D7-8401-4A8C-8BA6-D8D58ACBB23E", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466324, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "ημερομηνία": "2026-03-20", "ώρα": "21:08:24", "timestamp_unix": 1774040904, "time_received": "20260320220822763", "indice": "27590", "message": "Παρακαλούμε καλέστε μας ξανά όταν θα είμαστε διαθέσιμοι.", "number": "+33198765432", "guid": "08C88E20-9B98-453F-B361-9BB06D3275D6", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466156, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "ώρα": "19:05:22", "timestamp_unix": 1774033522, "time_received": "20260320200026246", "indice": "27588", "message": "Υπενθύμιση: ο έλεγχος του λογαριασμού σας εκκρεμεί.", "number": "10001", "guid": "551B2CF4-9330-4DD2-B2BA-5A4026EEEB15", "alias": null, "apikey": "YOUR_API_KEY_HASH" } ] } }

Εξήγηση απάντησης:

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

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

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

Παράμετρος: 

Παράδειγμα:

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

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

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

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

Παράμετροι: 

Παράδειγμα: 

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

Διαγραφή SMS

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

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

Παράμετροι:

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

Παράδειγμα απόκρισης JSON:

{ "αποτέλεσμα": { "σφάλμα": null, "count_delete": 1 } }

Εξήγηση απάντησης:

Σημείωση: διαγράφονται μόνο τα SMS που είναι αποθηκευμένα στα αρχεία καταγραφής του διακομιστή SMSMobileAPI. Τα μηνύματα 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 για να ορίσετε πόσα πιο πρόσφατα μηνύματα θα πρέπει να συμπεριληφθούν.

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

Παράμετροι: 

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

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

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

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

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

Παράδειγμα 5 - Λειτουργία συνέχισης με τα τελευταία 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" } ] } ] }

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

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

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

Σημειώσεις:

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

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

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

Παράμετροι:

Παράδειγμα:

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

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

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

Παράμετροι:

Παράδειγμα:

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

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

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

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

Παράμετροι:

Παράδειγμα:

Webhook – Λήφθηκε SMS

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

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

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

1. Συνδεθείτε στον λογαριασμό σας στο SMS Mobile API Dashboard.
2. Πλοηγηθείτε στο Ρυθμίσεις Webhook τμήμα.
3. Εισαγάγετε τη διεύθυνση URL του webhook σας (π.χ. https://example.com/webhook-endpoint).
4. Κάντε κλικ στο Αποθήκευση Webhook κουμπί. 
5. Μόλις αποθηκευτεί, το σύστημα θα αρχίσει να στέλνει λεπτομέρειες 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, χρησιμοποιήστε εργαλεία όπως:

• Webhook.site
• RequestBin

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

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

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

Πιστοποίηση

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

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

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

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

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

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

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

Χρήση του Access Token:

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

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

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