← Integrationen & API

Die DataLion REST-API nutzen

Über die REST-API binden Sie DataLion an eigene Systeme an: Daten importieren, Codebooks und Reports verwalten oder Ergebnistabellen abrufen. Jede Anfrage meldet sich mit einem API-Token an. Seit DataLion 2026.2.198 gibt es außerdem eine Nutzer-API, über die auch Personen ohne Adminrechte Berichtstabellen und Rohdaten lesen können.

Voraussetzungen

  • Ein Administratorkonto für API-Tokens. Die Nutzer-API ist für Konten ohne Adminrechte gedacht.
  • Für die Nutzer-API und die festen Token-Laufzeiten: DataLion ab Release 2026.2.198.

Die API-Dokumentation

Jede DataLion-Instanz beschreibt ihre API unter https://<Ihre DataLion-Adresse>/docs. Die Seite ist ohne Anmeldung erreichbar, listet alle Endpunkte mit Parametern und Beispielen und lässt Sie Anfragen direkt ausprobieren. Unter /docs.openapi liegt dieselbe Beschreibung als OpenAPI-Datei für Werkzeuge wie Postman.

Alle Anfragen schicken den Token im Header mit:

Authorization: Bearer <Ihr Token>

Einen API-Token anlegen

  1. Öffnen Sie Admin → Integrationen → API-Zugriff.
  2. Vergeben Sie einen Tokennamen, an dem Sie später erkennen, wofür der Token ist.
  3. Wählen Sie den Zweck. Er legt fest, was der Token darf:
    • Power BI: nur Lesen von Projekten und dem BI-Feed.
    • Schreibgeschützte Integration (voreingestellt): Projekte, Daten, Reports, Charts, Codebooks und Dokumente lesen.
    • Analyst: Lesen und zusätzlich Daten importieren.
    • Report Builder: Daten, Reports, Charts, Codebooks und Dokumente verwalten.
    • Admin Builder: wie Report Builder, dazu Projekte anlegen und verwalten. Unter Berechtigungen sehen Sie die einzelnen Rechte des gewählten Zwecks.
  4. Wählen Sie unter Gültigkeit 30, 90 oder 365 Tage. Voreingestellt sind 90 Tage. Tokens ohne Ablaufdatum lassen sich nicht mehr anlegen.
  5. Klicken Sie auf API-Token erstellen und kopieren Sie den Token. DataLion zeigt ihn nur dieses eine Mal an.

Unter Ihre API-Tokens sehen Sie, wann ein Token zuletzt benutzt wurde und wann er abläuft, und können ihn widerrufen. Läuft ein Token ab, schlagen Anfragen mit ihm fehl. Legen Sie dann einen neuen an.

Die Nutzer-API für Nutzer ohne Adminrechte

Mit der Nutzer-API geben Sie ausgewählten Nutzern einen Token, der nur lesen darf: die Datenquellen eines Projekts, freigegebene Berichtstabellen und, wenn Sie es erlauben, Rohdaten. Schreiben, importieren oder andere Endpunkte aufrufen kann ein solcher Token nicht.

Im Arbeitsbereich einschalten und Tokens vergeben

  1. Öffnen Sie Admin → Integrationen → Nutzer-API.
  2. Schalten Sie Nutzer-API in diesem Workspace aktivieren ein.
  3. Wählen Sie unter Tokens erstellen die Nutzer, einen Namen des Tokens und die Gültigkeit (30, 90 oder 365 Tage).
  4. Klicken Sie auf Tokens erstellen. Jeder ausgewählte Nutzer bekommt einen eigenen Token.

Je Projekt freigeben

Die Nutzer-API liefert nur Projekte, die Sie dafür freigegeben haben. Öffnen Sie unter Admin → Projekte das Projekt und dort Nutzer-API:

  1. Schalten Sie Nutzer-API für dieses Projekt aktivieren ein. Darunter steht die API-Adresse des Projekts.
  2. Legen Sie unter Rohdaten fest, was abrufbar ist:
    • Keine Rohdaten,
    • Gefilterte Rohdaten: Die Zugangsprofile des Nutzers gelten,
    • Vollständige Rohdaten: Zugangsprofile gelten nicht.
  3. Unter Spalten ausschließen wählen Sie Spalten, die die API nie ausgibt, zum Beispiel E-Mail-Adressen oder Freitexte.
  4. Mit Berichtstabellen erlauben geben Sie die Tabellen der Reports frei. Unter Berichte in der API nehmen Sie einzelne Reports wieder heraus. Neue Reports sind enthalten, bis Sie den Haken entfernen.

Gesperrte Konten und Administratoren können die Nutzer-API nicht verwenden. Ist der Schalter im Arbeitsbereich aus, lehnt DataLion alle Nutzer-API-Tokens ab.

KI-Agenten und Power BI