Übersicht
Zweck der API
Die API ermöglicht externen Systemen, Tools und Agenten direkten Zugriff auf den LogicBasis‑Kern. Jede Anfrage benötigt einen gültigen API‑Key.
Authentifizierung
Bearer‑Key
API‑Keys werden als Bearer‑Token gesendet und intern gehasht (SHA‑256). Kein Klartext, kein Upload, kein GitHub.
Authorization: Bearer lb_XXXXXXXXXXXXXXXX Content-Type: application/json
Endpoints
Deutsch & Englisch
POST https://app.logicbasis.ch/api/chat POST https://app.logicbasis.ch/api/chat-en
{
"message": "Deine Eingabe",
"sessionId": "optional"
}Parameter
message & sessionId
- message – string, erforderlich
- sessionId – string, optional (aktiviert Memory)
Antwort
JSON‑Struktur
{
"reply": "Antwort von LogicBasis"
}Fehlercodes
Deterministisch
- 200 – Soft Error (Nachricht fehlt, Plan inaktiv)
- 401 – Ungültiger API‑Key
- 429 – Monatliches Limit erreicht
- 500 – Technischer Fehler
Limits
Standard & Plus
- Standard: 1000 Anfragen / Monat
- Plus: 5000 Anfragen / Monat
- Reset: 1. Tag jedes Monats
Beispiele
JS / Python / cURL
await fetch("https://app.logicbasis.ch/api/chat", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({ message: "Hallo LogicBasis" })
});Sicherheit
API‑Key Schutz
- API‑Key niemals im Client verwenden
- API‑Key niemals in GitHub hochladen
- API‑Key wie ein Passwort behandeln
- Bei Verdacht sofort regenerieren