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

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

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

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

.
API REST
cURL
Composer
JavaScript JavaScript
Πύθων Πύθων
Node.js Node.js
Ρουμπίνι Ρουμπίνι
WSDL

Αποστολή SMS & WhatsApp API

Αυτό το τελικό σημείο σάς επιτρέπει να στέλνετε ένα SMS από το κινητό σας τηλέφωνο.
ΠΑΙΡΝΩ ΘΕΣΗ https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=PHONE_NUMBER&message=MESSAGE_TO_SEND

Παράμετροι:

- apikey: Το μοναδικό κλειδί API σας.
- recipients: Ο αριθμός τηλεφώνου του παραλήπτη.
- message: Το μήνυμα προς αποστολή (Το μήκος του μηνύματος δεν περιορίζεται στους 160 χαρακτήρες, μπορείτε να στείλετε μεγαλύτερα μηνύματα)
- sendwa: 1 = το μήνυμα πρέπει να σταλεί μέσω WhatsApp.
- sendsms: 1 = το μήνυμα πρέπει να σταλεί μέσω παραδοσιακού SMS. (Αν στέλνει μηνύματα είναι κενό: αποστέλλεται από προεπιλογή, ορίζεται στο 0 για αποκλεισμό του SMS)
- schedule_timestamp = Αντιπροσωπεύει την ώρα από την οποία πρέπει να σταλεί το SMS - Πρέπει να είναι **χρονοσήμανση UNIX (GMT 0)**

Παράδειγμα:

ΛΑΒΕ https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld
Σημείωση: Σε περίπτωση σφάλματος παράδοσης που προκαλείται από τον χειριστή σας, μια προεπιλεγμένη λειτουργία επαναλαμβάνει την αποστολή του ίδιου SMS έως και 3 φορές μέσα σε ένα καθορισμένο διάστημα.

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

1. API Key Authentication για αποστολή SMS

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

2. Έλεγχος ταυτότητας OAuth2 για αποστολή SMS

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

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

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

Για να λάβετε ένα διακριτικό πρόσβασης, στείλτε ένα αίτημα POST στο τελικό σημείο του διακριτικού με το αναγνωριστικό πελάτη και το μυστικό πελάτη.

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=1ab0ex4b4c1ef2c800690d" \
-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"

Χρήση του Access Token:

Μόλις έχετε το διακριτικό πρόσβασης, συμπεριλάβετέ το στο Εξουσιοδότηση κεφαλίδα των αιτημάτων σας API:

curl -X POST https://api.smsmobileapi.com/sendsms \
-H "Εξουσιοδότηση: Bearer abc123xyz456" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "recipients=+1234567890" \
-d "message=Hello"

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

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

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

Για περισσότερες λεπτομέρειες, ανατρέξτε στην πλήρη τεκμηρίωση.


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

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

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

Παράμετρος:

- guid: (απαιτείται) GUID του μηνύματος που πρέπει να σταλεί εκ νέου.


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

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

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

Παράμετρος:

- apikey: (απαιτείται) Το κλειδί api σας.
- guid_message: σύντομο από το μοναδικό αναγνωριστικό για το μήνυμα που χρησιμοποιείται για ταξινόμηση και φιλτράρισμα.
- before: Ανακτήστε μηνύματα που έχουν σταλεί πριν από αυτήν τη συγκεκριμένη χρονική σήμανση ή GUID.
- error_api: Εισαγάγετε «1» (`&error_api=1`) για να εμφανίσετε όλα τα SMS που αντιμετώπισαν σφάλμα κατά το αίτημα API.
- error_mobile: Εισαγάγετε `1` (`&error_mobile=1`) για να εμφανίσετε όλα τα SMS που αντιμετώπισαν σφάλμα κατά την επεξεργασία μέσω κινητού.
- keyword: Μια λέξη-κλειδί για το φιλτράρισμα των μηνυμάτων με βάση τον αριθμό του παραλήπτη ή το περιεχόμενο SMS.


Λάβετε SMS που λαμβάνονται στο API για κινητά

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

ΠΑΙΡΝΩ https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY

Παράμετρος:

- apikey: Το κλειδί API που έχετε ή θα λάβετε.


Διαγραφή SMS API

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

ΠΑΙΡΝΩ https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY

Παράμετρος:

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

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

.

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",
"time_received": "2025-01-20 10:14:50",
"message": "Γεια σας, αυτή είναι μια δοκιμή.",
"number": "+123456789",
"guid": "abcde12345"
}

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

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

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

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

<?php
// Διαβάστε το εισερχόμενο ωφέλιμο φορτίο
$payload = file_get_contents('php://input');
$data = json_decode($payload, true);


// Επεξεργαστείτε τα δεδομένα SMS
if ($data) {
// Παράδειγμα: Καταγραφή των δεδομένων SMS σε ένα αρχείο
file_put_contents('sms_log.txt', print_r($data, true), FILE_APPEND);


// Απάντηση με κατάσταση HTTP 200
http_response_code(200);
echo "Το Webhook ελήφθη με επιτυχία.";
} αλλο {
// Απάντηση με κατάσταση HTTP 400 για εσφαλμένα αιτήματα
http_response_code(400);

echo "Μη έγκυρο ωφέλιμο φορτίο.";
}
?>

Δοκιμή του Webhook

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

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

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

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

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


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

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

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

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

Κατεβάστε την Εφαρμογή
Συνδέστε το κινητό μου