Παράδειγμα:

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

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

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

Παράμετρος: 

Παράδειγμα:

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

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

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

Παράμετρος:

Παράδειγμα:

Λήφθηκε SMS

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

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

Παράμετρος: 

Παράδειγμα:

Διαγραφή SMS

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

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

Παράμετρος:

Παράδειγμα:

Σημείωση: Τα διαγραμμένα 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.site
• RequestBin

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

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

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

Πιστοποίηση

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

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

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

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

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

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

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

Χρήση του Access Token:

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

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

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

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

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