Zum Inhalt

SMSBAT-API

SMSBAT ist eine RESTful-API-Plattform zum Senden verschiedener Arten von Nachrichten, darunter Viber-Karussell, Viber-Meinungsdialog, Viber-Promo (Bilder, Video), Viber-Business-Chat, OTP-Benachrichtigungen (Viber OTP, Flash Call) und deren Fallback-Varianten.

Basis-URL

Anfragen an die SMSBAT-API werden mit Lokalisierung an einen Endpunkt übermittelt. Erfragen Sie die Adresse vorher bei Ihrem Vorgesetzten.

Beispiel: „https://restapi.smsbat.com“ (die tatsächliche URL kann je nach Region variieren)

Authentifizierung

Die SMSBAT-API unterstützt drei Authentifizierungsmethoden:

Methode 1: HTTP-Basisauthentifizierung

Verwenden Sie Ihren Benutzernamen und Ihr Passwort:

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

Methode 2: API-Schlüsselheader

Verwenden Sie den Header „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

Methode 3: API-Schlüssel als Passwort

Verwenden Sie „@“ als Benutzernamen und Ihren API-Schlüssel als Passwort:

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

Verfügbare Endpunkte

Methode Endpunkt Beschreibung
POST /bat/messagelist Nachrichten senden
GET /bat/message/{messageId} Nachrichtenstatus prüfen

Nachrichtentypen

Die SMSBAT-API unterstützt die folgenden Nachrichtentypen:

  • SMS – Standard-Textnachrichten
  • Viber Promo – Werbebotschaften mit Rich Media
  • Viber Transactional – Transaktionsbenachrichtigungen
  • Viber-Karussell – Interaktive Karussellnachrichten
  • Viber-Umfrage – Meinungsdialognachrichten
  • Viber OTP – Einmalpasswortbenachrichtigungen
  • RCS – Rich Communication Services-Nachrichten
  • Flash Call – Überprüfung des stillen Anrufs

Hauptmerkmale

Fallback-Nachrichten

Wenn die primäre Zustellung fehlschlägt, greift SMSBAT automatisch auf alternative Kanäle zurück:

Viber → SMS → Email

Rich Media-Unterstützung

Senden Sie Nachrichten mit:

  • Bilder (JPG, PNG)
  • Videos (MP4)
  • PDFs
  • Schaltflächen und Aktionslinks

Nachrichtenstatusverfolgung

Verfolgen Sie den Lieferstatus in Echtzeit:

  • Gesendet
  • Geliefert
  • Lesen
  • Fehlgeschlagen
  • Abgelaufen

Rückrufe

Empfangen Sie eingehende Viber-Nachrichtenrückrufe für die bidirektionale Kommunikation.

Schnellstart

  1. Nachricht senden – Erfahren Sie, wie Sie Ihre erste Nachricht senden
  2. Status prüfen – Verfolgen Sie den Status der Nachrichtenzustellung
  3. Nachrichtentypen – Entdecken Sie verschiedene Nachrichtentypen

Anforderungsformat

Alle Anfragen verwenden das JSON-Format mit der folgenden Struktur:

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

Antwortformat

Erfolgreiche Antworten geben Folgendes zurück:

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

Fehlerbehandlung

HTTP-Statuscodes:

  • „200 OK“ – Anfrage erfolgreich
  • „400 Bad Request“ – Ungültiges Anforderungsformat
  • „401 Unauthorized“ – Authentifizierung fehlgeschlagen
  • „429 Too Many Requests“ – Ratenlimit überschritten
  • „500 Internal Server Error“ – Serverfehler

Nächste Schritte