Gå til indholdet

SMSBAT API

SMSBAT er en RESTful API-platform til afsendelse af forskellige typer beskeder, herunder Viber-karrusel, Viber-meningsdialog, Viber-promo (billeder, video), Viber-forretningschat, OTP-meddelelser (Viber OTP, Flash Call) og deres fallback-varianter.

Basis-URL

Forespørgsler til SMSBAT API sendes til et slutpunkt med lokalisering. Anmod om adressen hos din leder på forhånd.

Eksempel: https://restapi.smsbat.com (den faktiske URL kan variere afhængigt af din region)

Godkendelse

SMSBAT API understøtter tre godkendelsesmetoder:

Metode 1: HTTP Basic Auth

Brug dit brugernavn og din adgangskode:

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

Metode 2: API-nøglehoved

Brug "X-Authorization-Key" overskriften:

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

Metode 3: API-nøgle som adgangskode

Brug @ som brugernavn og din API-nøgle som adgangskode:

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

Tilgængelige endepunkter

Metode Slutpunkt Beskrivelse
POST /bat/messagelist Send beskeder
FÅ /bat/meddelelse/{messageId} Tjek beskedstatus

Meddelelsestyper

SMSBAT API understøtter følgende meddelelsestyper:

  • SMS - Standard tekstbeskeder
  • Viber Promo - Salgsfremmende beskeder med rich media
  • Viber Transactional - Transaktionsmeddelelser
  • Viber Carousel - Interaktive karruselbeskeder
  • Viber Survey - Meningsdialogmeddelelser
  • Viber OTP - Engangsadgangskodemeddelelser
  • RCS - Rich Communication Services-meddelelser
  • Flash-opkald - Tavs opkaldsbekræftelse

Nøglefunktioner

Fallback-meddelelser

Når primær levering mislykkes, falder SMSBAT automatisk tilbage til alternative kanaler:

Viber → SMS → Email

Rich Media Support

Send beskeder med:

  • Billeder (JPG, PNG)
  • Videoer (MP4)
  • PDF'er
  • Knapper og handlingslinks

Sporing af meddelelsesstatus

Spor leveringsstatus i realtid:

  • Sendt
  • Leveret
  • Læs
  • Mislykkedes
  • Udløbet

Tilbagekald

Modtag indgående Viber-besked-tilbagekald til tovejskommunikation.

Hurtig start

  1. Send en besked - Lær, hvordan du sender din første besked
  2. Kontroller status - Spor meddelelsesleveringsstatus
  3. Meddelelsestyper - Udforsk forskellige meddelelsestyper

Forespørgselsformat

Alle anmodninger bruger JSON-format med følgende struktur:

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

Svarformat

Vellykkede svar returnerer:

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

Fejlhåndtering

HTTP-statuskoder:

  • 200 OK - Forespørgsel gennemført
  • 400 Bad Request - Ugyldigt anmodningsformat
  • 401 Uautoriseret - Godkendelse mislykkedes
  • 429 for mange anmodninger - Satsgrænsen er overskredet
  • 500 Intern serverfejl - Serverfejl

Næste trin