API-Schlüssel
Video zur Funktion
Für wen ist das gedacht?
- Für technische Teams, die Leexi mit ihren eigenen Tools, Skripten oder internen Produkten verbinden.
- Für Administratoren, die den Abruf von Anrufen, Meeting-Protokollen und Meeting-Ereignissen automatisieren.
Berechtigungen und Lizenzen
- Die öffentliche API ist ab dem Plan AI Meeting verfügbar.
- Das Ansehen der Schlüssel erfordert die Leseberechtigung für API-Schlüssel, das Erstellen und Ändern die Schreibberechtigung.
Anleitung
Die Seite API-Schlüssel öffnen
Gehen Sie zu Einstellungen > Erweiterte Einstellungen > API-Schlüssel. Die Liste zeigt für jeden Schlüssel den Namen, die Zugriffsregeln, die Beschreibung, die Berechtigungen, das Erstellungsdatum, die letzte Verwendung und die Person, die ihn erstellt hat.
Einen Schlüssel erstellen
Klicken Sie auf "Hinzufügen". Leexi erzeugt eine Schlüssel-ID und ein Geheimnis. Kopieren Sie beide sofort, indem Sie auf die jeweiligen Felder klicken: Das Geheimnis ist nur bei der Erstellung sichtbar.
Den Schlüssel benennen und beschreiben
Geben Sie einen Namen und eine Beschreibung ein, die das betreffende Tool oder den Verwendungszweck kennzeichnen. So finden Sie später den richtigen Schlüssel und können ihn widerrufen.
Die Berechtigungen auswählen
Wählen Sie die gewährten Berechtigungen aus: Anrufe lesen und schreiben, Meeting-Ereignisse lesen und schreiben, Benutzer, Teams und Unternehmen lesen. Aktivieren Sie nur, was das Tool wirklich benötigt.
Die Zugriffsregeln festlegen
Es stehen drei Modi zur Verfügung:
- Mit einem Benutzer verknüpft: Der Schlüssel übernimmt die Zugriffsrechte des gewählten Benutzers.
- Zugriff auf alles: Der Schlüssel greift auf alle Anrufe des Unternehmens zu.
- Benutzerdefinierter Zugriff: Nach dem Speichern werden Sie zur Seite Zugriffsregeln weitergeleitet, um den genauen Umfang festzulegen.
Ihre Anfragen authentifizieren
Verwenden Sie die ID und das Geheimnis als HTTP-Basic-Authentifizierung unter https://public-api.leexi.ai/v1/. Die Endpunkte, Parameter und Antwortformate sind in der Referenz der öffentlichen API beschrieben.
Weiterführende Informationen
- Über die Spalte "Letzte Verwendung" erkennen Sie ungenutzte Schlüssel, die Sie löschen sollten, wenn das zugehörige Tool nicht mehr im Einsatz ist.
- Die öffentliche API ist auf 50 Anfragen pro Minute begrenzt, und auf 10 Anfragen pro Minute für die Erstellung von Anrufen.
- Name, Beschreibung, Berechtigungen und Zugriffsregeln eines Schlüssels lassen sich jederzeit über einen Klick auf die entsprechende Zeile ändern: ID und Geheimnis bleiben dagegen unverändert.
- Webhooks decken das umgekehrte Bedürfnis ab: Anstatt die API abzufragen, erhalten Sie ein Ereignis, sobald ein Anruf verarbeitet wurde.
Häufige Fragen
Wichtige Hinweise
- Ein Schlüssel gewährt Zugriff auf Daten ohne Benutzerauthentifizierung: Bewahren Sie das Geheimnis in einem Secret-Manager auf, niemals in einem Code-Repository oder einer Nachricht.
- Der Modus "Zugriff auf alles" umgeht die Trennung nach Teams: Behalten Sie ihn Integrationen vor, die ihn wirklich benötigen.
- Ein Schlüssel bleibt gültig, auch wenn die Person, die ihn erstellt hat, das Unternehmen verlässt: Prüfen Sie die Schlüssel bei jedem Austritt.
- Schreibberechtigungen erlauben das Erstellen und Ändern von Daten in Leexi: Vergeben Sie sie sparsam.