BIB SMS & WhatsApp Gateway API

Gibt ein JWT-Token zurück das für weitere Anfragen genutzt wird.

Request Body

Beispiel

POST /api/v1/auth/login
Content-Type: application/json

{
  "username": "meinuser",
  "password": "meinPasswort"
}

Antwort

{
  "token": "eyJhbGciOiJIUzI...",
  "user": {
    "id": 1,
    "username": "meinuser",
    "role": "user",
    "api_key": "bc9f5db8f8ebc..."
  }
}

Antwort

{
  "success": true,
  "token": "eyJhbGciOiJIUzI...",
  "user": { ... }
}

Gibt alle Informationen zum aktuellen Benutzer zurück inkl. Guthaben.

Antwort

{
  "id": 2,
  "username": "meinuser",
  "email": "[email protected]",
  "sms_balance": 50,
  "wa_balance": 25,
  "sub_sms_remaining": 1000,
  "sub_wa_remaining": 500,
  "api_key": "bc9f5db8..."
}

Generiert einen neuen API-Key. Der alte Key wird sofort ungültig.

Antwort

{ "api_key": "neuer_api_key..." }

Stellt eine SMS in die Warteschlange. Das Android-Gateway sendet sie automatisch.

Beispiel (cURL)

curl -X POST https://sms.eg24.eu/api/v1/sms/send \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+491621234567",
    "message": "Hallo, das ist ein Test!",
    "name": "Max Mustermann"
  }'

Antwort

{ "success": true }

Fehler (402)

{ "error": "Kein SMS-Guthaben", "need_payment": true }

Stellt eine WhatsApp-Nachricht in die Warteschlange. Optional mit Datei-Anhang (vorher hochladen via /file/upload).

Ablauf mit Datei

1. POST /file/upload  → Datei hochladen
2. POST /whatsapp/send → has_file: true
3. Android lädt Datei + sendet via WhatsApp

Beispiel (cURL)

curl -X POST https://sms.eg24.eu/api/v1/whatsapp/send \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+491621234567",
    "message": "Hier ist die Rechnung",
    "name": "Max",
    "has_file": true
  }'

Sendet eine WhatsApp-Nachricht mit Datei-Anhang in einem einzigen API-Call. Kein separater Upload nötig.

Content-Type: multipart/form-data

Beispiele

curl -X POST https://sms.eg24.eu/api/v1/whatsapp/send-document \
  -H "Authorization: Bearer DEIN_API_KEY" \
  -F "phone=+491621234567" \
  -F "message=Hier ist deine Rechnung" \
  -F "name=Max Mustermann" \
  -F "file=@rechnung.pdf"

import requests
r = requests.post('https://sms.eg24.eu/api/v1/whatsapp/send-document',
    headers={'Authorization': 'Bearer DEIN_API_KEY'},
    data={'phone': '+491621234567', 'message': 'Hier die Rechnung', 'name': 'Max'},
    files={'file': open('rechnung.pdf', 'rb')})
print(r.json())

const form = new FormData();
form.append('phone', '+491621234567');
form.append('message', 'Hier die Rechnung');
form.append('name', 'Max');
form.append('file', fileBlob, 'rechnung.pdf');
const r = await fetch('https://sms.eg24.eu/api/v1/whatsapp/send-document', {
  method: 'POST',
  headers: {'Authorization': 'Bearer DEIN_API_KEY'},
  body: form
});
console.log(await r.json());

$ch = curl_init('https://sms.eg24.eu/api/v1/whatsapp/send-document');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer DEIN_API_KEY']);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'phone' => '+491621234567',
    'message' => 'Hier die Rechnung',
    'name' => 'Max',
    'file' => new CURLFile('rechnung.pdf')
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);

Lädt eine Datei hoch die beim nächsten WhatsApp-Versand angehängt wird. Vorherige Dateien werden überschrieben.

Content-Type: multipart/form-data

Beispiel (cURL)

curl -X POST https://sms.eg24.eu/api/v1/file/upload \
  -H "Authorization: Bearer DEIN_TOKEN" \
  -F "[email protected]"

Antwort

{
  "success": true,
  "file_name": "rechnung.pdf",
  "file_size": 123800
}

Löscht die aktuell hochgeladene Datei. Wird automatisch nach WhatsApp-Versand aufgerufen.

Antwort

{
  "messages": [
    {
      "id": 1,
      "phone": "+491621234567",
      "message": "Antwort des Empfängers",
      "read": false,
      "created_at": "2026-02-16 15:30:00"
    }
  ]
}

Wird vom Gateway gesendet wenn eine eingehende WhatsApp-Nachricht erkannt wird. Erscheint im Posteingang mit WhatsApp-Badge.

curl -X POST https://sms.eg24.eu/api/v1/whatsapp/inbox/add?api_key=KEY \
  -H "Content-Type: application/json" \
  -d '{"sender": "Max", "message": "Hallo!"}'

Gibt die letzten 200 Anrufe zurück.

Antwort

{
  "calls": [
    {
      "id": 1,
      "phone": "+491621234567",
      "contact_name": "Max",
      "call_type": "incoming",
      "duration": 45,
      "status": "answered",
      "created_at": "2026-03-11 14:30:00"
    }
  ]
}

Antwort

{
  "notify_phone": "+491621234567",
  "notify_sms": true,
  "notify_calls": true
}

curl -X POST https://sms.eg24.eu/api/v1/auth/notify-settings \
  -H "Authorization: Bearer DEIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "notify_phone": "+491621234567",
    "notify_sms": true,
    "notify_calls": true
  }'

Gibt die nächste ausstehende SMS zurück und markiert sie als gesendet.

Antwort (mit Nachricht)

{
  "pending": true,
  "data": {
    "phone": "+491621234567",
    "message": "Hallo Welt",
    "name": "Max"
  }
}

Antwort (keine Nachricht)

{ "pending": false }

Antwort (mit Nachricht + Datei)

{
  "pending": true,
  "data": {
    "phone": "+491621234567",
    "message": "Hier die Rechnung",
    "name": "Max",
    "has_file": true
  }
}

Gibt die hochgeladene Datei als Binary zurück. Dateiname im Content-Disposition Header.

Gibt text/plain "none" zurück wenn keine Datei vorhanden.

Antwort

{
  "customers": [
    { "id": 1, "name": "Max", "phone": "+491621234567", "email": "[email protected]" }
  ]
}

Antwort

{
  "messages": [
    {
      "id": 1,
      "direction": "out",
      "channel": "whatsapp",
      "phone": "+491621234567",
      "customer_name": "Max",
      "message": "Hallo!",
      "file_name": "rechnung.pdf",
      "status": "queued",
      "cost": 0.50,
      "created_at": "2026-02-16 15:30:00"
    }
  ]
}

Antwort

{
  "status": "online",
  "sms_balance": 50,
  "wa_balance": 25,
  "sms_queue": 0,
  "whatsapp_queue": 0,
  "inbox_count": 5,
  "inbox_unread": 2,
  "has_file": false
}

Kein Auth erforderlich.

Antwort

{
  "sms_price": 0.50,
  "wa_price": 0.50,
  "packages": [
    { "amount": 10, "price": 4.99 },
    { "amount": 50, "price": 19.99 }
  ],
  "subscription": {
    "price": 29.99,
    "sms": 1000,
    "wa": 1000
  }
}

Server verifiziert die PayPal-Zahlung vor der Gutschrift.

Exportiert Kontakte, Vorlagen, Nachrichten und Posteingang als JSON.

Importiert zuvor exportierte Daten. Existierende Daten werden ergänzt, nicht überschrieben.