Μετάβαση στο περιεχόμενο

SMSBAT API

Το SMSBAT είναι μια RESTful πλατφόρμα API για την αποστολή διαφόρων τύπων μηνυμάτων, όπως Viber καρουζέλ, διάλογος γνώμης Viber, προώθηση Viber (εικόνες, βίντεο), επιχειρηματική συνομιλία Viber, ειδοποιήσεις OTP (Viber OTP, Flash Call) και εναλλακτικές παραλλαγές τους.

Βασική διεύθυνση URL

Τα αιτήματα για το SMSBAT API μεταδίδονται σε ένα τελικό σημείο με εντοπισμό. Ζητήστε τη διεύθυνση από τον διευθυντή σας εκ των προτέρων.

Παράδειγμα: https://restapi.smsbat.com (η πραγματική διεύθυνση URL μπορεί να διαφέρει ανάλογα με την περιοχή σας)

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

Το SMSBAT API υποστηρίζει τρεις μεθόδους ελέγχου ταυτότητας:

Μέθοδος 1: HTTP Basic Auth

Χρησιμοποιήστε τα διαπιστευτήρια ονόματος χρήστη και κωδικού πρόσβασης:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d @request.json

Μέθοδος 2: Κεφαλίδα κλειδιού API

Χρησιμοποιήστε την κεφαλίδα "X-Authorization-Key":

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Μέθοδος 3: Κλειδί API ως κωδικός πρόσβασης

Χρησιμοποιήστε το «@» ως όνομα χρήστη και το κλειδί API ως κωδικό πρόσβασης:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Διαθέσιμα τελικά σημεία

Μέθοδος Τελικό σημείο Περιγραφή
ΑΝΑΡΤΗΣΗ /bat/messagelist Αποστολή μηνυμάτων
ΠΑΡΕ /bat/message/{messageId} Ελέγξτε την κατάσταση του μηνύματος

Τύποι μηνυμάτων

Το SMSBAT API υποστηρίζει τους ακόλουθους τύπους μηνυμάτων:

  • SMS - Τυπικά μηνύματα κειμένου
  • Viber Promo - Προωθητικά μηνύματα με πλούσια μέσα
  • Viber Transactional - Ειδοποιήσεις συναλλαγών
  • Viber Carousel - Διαδραστικά μηνύματα καρουζέλ
  • Viber Survey - Μηνύματα διαλόγου γνώμης
  • Viber OTP - Εφάπαξ ειδοποιήσεις κωδικού πρόσβασης
  • RCS - Εμπλουτισμένα μηνύματα Υπηρεσιών Επικοινωνίας
  • Flash Call - Αθόρυβη επαλήθευση κλήσης

Βασικά χαρακτηριστικά

Εναλλακτικά μηνύματα

Όταν η κύρια παράδοση αποτύχει, το SMSBAT επιστρέφει αυτόματα σε εναλλακτικά κανάλια:

Viber → SMS → Email

Υποστήριξη εμπλουτισμένων μέσων

Στείλτε μηνύματα με:

  • Εικόνες (JPG, PNG)
  • Βίντεο (MP4)
  • PDF
  • Κουμπιά και σύνδεσμοι δράσης

Παρακολούθηση κατάστασης μηνυμάτων

Παρακολουθήστε την κατάσταση παράδοσης σε πραγματικό χρόνο:

  • Εστάλη
  • Παραδόθηκε
  • Διαβάστε
  • Απέτυχε
  • Λήγει

Επανακλήσεις

Λάβετε ανακλήσεις εισερχόμενων μηνυμάτων Viber για αμφίδρομη επικοινωνία.

Γρήγορη εκκίνηση

  1. Send a Message - Μάθετε πώς να στείλετε το πρώτο σας μήνυμα
  2. Έλεγχος κατάστασης - Παρακολουθήστε την κατάσταση παράδοσης μηνυμάτων
  3. Τύποι μηνυμάτων - Εξερευνήστε διαφορετικούς τύπους μηνυμάτων

Μορφή αιτήματος

Όλα τα αιτήματα χρησιμοποιούν μορφή JSON με την ακόλουθη δομή:

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "type": "viber",
      "text": "Your message here",
      // ... additional parameters
    }
  ]
}

Μορφή απόκρισης

Επιστροφή επιτυχών απαντήσεων:

{
  "messages": [
    {
      "messageId": "unique-message-id",
      "recipient": "+380XXXXXXXXX",
      "status": "sent"
    }
  ]
}

Χειρισμός σφαλμάτων

Κωδικοί κατάστασης HTTP:

  • 200 OK - Το αίτημα επιτυχής
  • 400 Bad Request - Μη έγκυρη μορφή αιτήματος
  • 401 Μη εξουσιοδοτημένο - Ο έλεγχος ταυτότητας απέτυχε
  • 429 Πάρα πολλά αιτήματα - Υπέρβαση του ορίου τιμής
  • 500 Εσωτερικό Σφάλμα διακομιστή - Σφάλμα διακομιστή

Επόμενα βήματα