Mit einem API-Schlüssel pflegt ein Programm dein Wissen oder holt Anfragen ab – zum Beispiel ein Abgleich, der jede Nacht die Preisliste aus deinem Shop einliest.
Im Wissens-Center auf Team & Zugriff, unten API-Schlüssel. Name, Rechte und Gültigkeit wählen.
Tipp: Gib einem Abgleich das Recht vorschlagen. Dann landet alles, was er einliest, als Entwurf bei dir – ein Fehler im Shop steht nicht ungeprüft im Chat.
Adresse: https://wissen.msg-i.de. Der Schlüssel reist in der Kopfzeile mit:
Authorization: Bearer msgi_…
Beispiel – eine Notiz hinterlegen:
curl -X POST https://wissen.msg-i.de/api/rag/text \
-H "Authorization: Bearer msgi_…" -H "Content-Type: application/json" \
-d '{"source": "Öffnungszeiten", "text": "Mo–Fr 7 bis 14 Uhr.", "collection": "allgemein"}'
Wissen lesen
GET /api/rag/sources – alle Quellen mit Ordner und Zahl der AbschnittePOST /api/rag/suche – {"frage": "…"} liefert die besten FundstellenPOST /api/rag/probe – {"frage": "…"} liefert die Antwort, die ein Besucher bekämeGET /api/rag/gaps – Fragen, die der Assistent nicht beantworten konnteGET /api/rag/versionen – wartende Entwürfe und frühere FassungenWissen vorschlagen oder pflegen
POST /api/rag/text – {"source": "Name", "text": "…", "collection": "Ordner"}. Gleicher Name ersetzt die alte Fassung.POST /api/rag/url – {"url": "https://…", "crawl_pages": 1, "collection": "Ordner"}POST /api/rag/upload?collection=Ordner – Datei als Formularfeld fileGET /api/rag/jobs/{nummer} – Stand eines Einlese-AuftragsNur mit „pflegen“
DELETE /api/rag/sources?source=NamePOST /api/rag/versionen/freigeben und /verwerfen – {"source": "Name"}Anfragen
GET /api/rag/leads – Kontaktanfragen aus dem Chat (Recht „lesen“)POST /api/rag/leads/{kennung}/erledigt – abhaken (Recht „lesen und abhaken“)401 – Schlüssel unbekannt, abgelaufen oder zurückgezogen.403 – der Schlüssel hat dieses Recht nicht.429 – zu viele Aufrufe. Je Schlüssel sind 600 Aufrufe in der Stunde möglich.