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

Αποστολή μηνύματος

Στείλτε μηνύματα μέσω του SMSBAT API χρησιμοποιώντας το τελικό σημείο /bat/messagelist.

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

POST /bat/messagelist

Δομή αιτήματος

Το σώμα του αιτήματος είναι ένας πίνακας JSON αντικειμένων μηνύματος:

{
  "messages": [
    {
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Your message text",
      "customerMessageId": "your-internal-id",
      "ttl": 3600
    }
  ]
}

Παράμετροι

Απαιτούμενες παράμετροι

Παράμετρος Τύπος Περιγραφή
«από» χορδή Αλφαριθμητικό αναγνωριστικό αποστολέα
«προς» χορδή Αριθμός τηλεφώνου παραλήπτη σε μορφή E.164 (π.χ. +380XXXXXXXXX)
«τύπος» χορδή Τύπος μηνύματος: sms, viber_promo, viber_trans, viber_carousel, viber_survey, viber_otp, rcs, flashcall
κείμενο χορδή Περιεχόμενο μηνύματος (απαιτείται για τους περισσότερους τύπους, προαιρετικό για ορισμένους)

Προαιρετικές παράμετροι

Παράμετρος Τύπος Περιγραφή
customerMessageId χορδή Το εσωτερικό σας αναγνωριστικό για παρακολούθηση
ttl ακέραιος Χρόνος ζωής σε δευτερόλεπτα
MessageData αντικείμενο Διαμόρφωση για συγκεκριμένο τύπο (διαφέρει ανάλογα με τον τύπο μηνύματος)

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

Επιλέξτε μία από τις τρεις μεθόδους ελέγχου ταυτότητας:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

Απάντηση

Απόκριση επιτυχίας

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 1,
      "customerMessageId": "your-internal-id",
      "to": "+380XXXXXXXXX"
    }
  ]
}

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

Πεδίο Τύπος Περιγραφή
messagelistId ακέραιος Μοναδικό αναγνωριστικό για τη λίστα μηνυμάτων
MessageId χορδή Μοναδικό αναγνωριστικό για κάθε μήνυμα
«κατάσταση» χορδή Κατάσταση μηνύματος: "αποδεκτό", "απορρίφθηκε", "αποτυχία"
«εξαρτήματα» ακέραιος Αριθμός τμημάτων μηνύματος (για SMS)
customerMessageId χορδή Το εσωτερικό σας αναγνωριστικό (αν παρέχεται)
«προς» χορδή Αριθμός τηλεφώνου παραλήπτη

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

SMS

Απλά μηνύματα κειμένου:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

Viber Promo

Προωθητικά μηνύματα με εμπλουτισμένα μέσα:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Check out our new product!",
  "messageData": {
    "image": "https://example.com/image.jpg",
    "button": {
      "text": "View Product",
      "url": "https://example.com/product"
    }
  }
}

Viber Transactional

Ειδοποιήσεις συναλλαγών:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed"
}

Viber OTP

Εφάπαξ ειδοποιήσεις κωδικού πρόσβασης:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "code": "123456",
    "validity": 300
  }
}

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

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

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

Απόκριση σφάλματος

{
  "error": {
    "code": "INVALID_RECIPIENT",
    "message": "Invalid phone number format"
  }
}

Βέλτιστες πρακτικές

Μορφή αριθμού τηλεφώνου

Να χρησιμοποιείτε πάντα τη μορφή E.164 για αριθμούς τηλεφώνου:

  • ✅ Σωστό: +380XXXXXXXXX
  • ❌ Λάθος: 380XXXXXXXXX, 0XXXXXXXXX

Κείμενο μηνύματος

  • Διατηρήστε SMS κάτω από 160 χαρακτήρες για να αποφύγετε πολλαπλά μέρη
  • Χρησιμοποιήστε κωδικοποίηση UTF-8 για διεθνείς χαρακτήρες
  • Δοκιμάστε ειδικούς χαρακτήρες πριν από τη μαζική αποστολή

TTL (Time-to-Live)

  • Ορίστε κατάλληλο TTL για μηνύματα ευαίσθητα στον χρόνο
  • Μηνύματα OTP: 300-600 δευτερόλεπτα (5-10 λεπτά)
  • Προωθητικά μηνύματα: 3600-86400 δευτερόλεπτα (1-24 ώρες)

Αναγνωριστικό μηνύματος πελάτη

  • Χρησιμοποιήστε μοναδικά αναγνωριστικά για κάθε μήνυμα
  • Βοηθά στην παρακολούθηση και τον εντοπισμό σφαλμάτων
  • Χρήσιμο για συσχετισμό με τις εγγραφές του συστήματός σας

Όρια ποσοστών

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

  • Μηνύματα ανά δευτερόλεπτο
  • Μηνύματα ανά ημέρα
  • Ταυτόχρονες συνδέσεις

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