Überblick
Authentifizierung
Schlüssel erstellen und bei jeder Anfrage mitsenden.
Jede Anfrage braucht einen Schlüssel. Es gibt keine Sitzungen und keine Anmeldung über Benutzername und Passwort.
Schlüssel erstellen
In der Plattform unter Einstellungen → API-Schlüssel auf Neuer Schlüssel. Das setzt Administratorrechte im Team voraus.
Der Schlüssel wird genau einmal angezeigt. Kopiere ihn sofort und lege ihn dort ab, wo ihr auch andere Zugangsdaten aufbewahrt. Geht er verloren, erstellst du einen neuen und löschst den alten.
Mitsenden
Der Schlüssel gehört als Bearer-Token in den Authorization-Kopf. Schlüssel beginnen mit np_.
curl https://app.elunos.ai/api/v1/knowledge/documents \\
-H "Authorization: Bearer np_xxxxxxxx"Grenzen
60 Anfragen pro Minute je Schlüssel. Wer darüber liegt, bekommt einen Fehler statt einer Antwort, also plane Massenimporte mit etwas Abstand zwischen den Aufrufen.
Der Schlüssel gehört auf den Server, nicht in eine Webseite oder App. Wer ihn hat, kann euer gesamtes Wissen lesen, ändern und löschen.