Die Looker API ist eine sichere RESTful-Anwendungsprogrammierschnittstelle zum Verwalten Ihrer Looker-Instanz und zum Abrufen von Daten über die Looker-Datenplattform. Mit der Looker API können Sie Anwendungen oder Automatisierungsscripts erstellen, um neue Looker-Benutzerkonten bereitzustellen, Abfragen durchzuführen, Datenübermittlungen zu planen usw. So ziemlich alles, was Sie in der Looker-Anwendung tun können, können Sie auch über die Looker API tun.
Pfad und Port der Looker API
Rufen Sie die API Ihrer Looker-Instanz über die API-URL auf.
Ihr Looker-Administrator kann einen API-Pfad angeben, indem er ihn auf der Seite Verwaltung > API im Feld API-Host-URL im folgenden Format eingibt:
https://<instance_name>.cloud.looker.com
Ihr Looker-Administrator kann auch das Feld API-Host-URL verwenden, um einen API-Pfad zuzuweisen, der sich vom Computernamen des Looker-Servers unterscheidet. Das ist häufig der Fall, wenn sich Ihre Looker-Installation beispielsweise hinter einem Load Balancer befindet. Wenden Sie sich in diesem Fall an Ihren Looker-Administrator, um den API-Pfad zu erfahren.
Wenn Ihr Looker-Administrator das Feld API-Host-URL nicht angegeben hat, verwendet Looker den Standard-API-Pfad. Für Looker-Instanzen, die in Google Cloud, Microsoft Azure und Amazon Web Services (AWS) gehostet werden und am oder nach dem 07.07.2020 erstellt wurden, wird für den Standardpfad der Looker API der Port 443 verwendet. Für Looker-Instanzen, die auf AWS gehostet und vor dem 07.07.2020 erstellt wurden, wird für den Standardpfad der Looker API der Port 19999 verwendet. Die Standard-API-URL hat das folgende Format:
https://<instance_name>.cloud.looker.com:<port>
Client-SDKs
Sie können die Looker API mit jeder Programmiersprache oder Anwendungsumgebung verwenden, die HTTPS-Anfragen stellen und JSON-Antworten verarbeiten kann. Sie können Looker API-HTTPS-Anfragen manuell mit curl (oder einem ähnlichen Tool), mit dem Looker Ruby SDK oder durch Generieren einer Client SDK-Bibliothek in Ihrer bevorzugten Sprache erstellen. Wir empfehlen die Verwendung eines SDKs, da es die Details der Authentifizierung und HTTPS-Anfragen für Sie übernimmt. So können Sie die Looker API mit einfachen Funktionsaufrufen aufrufen.
SDK-Details finden Sie auf der Dokumentationsseite Looker API SDKs.
Authentifizierung
Looker authentifiziert API-Anfragen mit einem OAuth 2.0-Inhaberzugriffstoken im HTTP-Autorisierungsheader der Anfrage. Für alle Looker API-Endpunkte ist eine sichere HTTPS-Verbindung erforderlich, damit das Zugriffstoken während der Übertragung sicher ist.
Die Schritte dazu hängen davon ab, ob Sie ein SDK verwenden. Eine ausführliche Anleitung finden Sie auf der Dokumentationsseite Looker API-Authentifizierung.
Interaktive API-Dokumentation
Die API Explorer-Erweiterung für API-Referenzdokumentationen ist im Looker Marketplace verfügbar. Weitere Informationen finden Sie auf der Dokumentationsseite API Explorer verwenden. Als Looker-Administrator können Sie auch über den Link API Explorer verwenden auf der Seite API auf den API Explorer zugreifen.
Versionsverwaltung
Die API-Stabilität ist ein wichtiger Aspekt beim Erstellen von Anwendungen. Damit Sie besser nachvollziehen können, welche Endpunkte in Zukunft möglicherweise geändert werden und welche stabil bleiben sollten, kennzeichnen wir bestimmte Endpunkte als Beta. Weitere Informationen finden Sie auf der Dokumentationsseite Versionierung der Looker API.