Die Looker API ist eine sichere RESTful-Anwendungsprogrammierschnittstelle zum Verwalten Ihrer Looker-Instanz und zum Abrufen von Daten über die Looker-Datenplattform. Mithilfe der Looker-API können Sie Anwendungen oder Automatisierungsskripte 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 über die Looker-API tun.
Looker API-Pfad und -Port
Über die API-URL Ihrer Looker-Instanz können Sie auf die API zugreifen.
Ihr Looker-Administrator kann einen API-Pfad angeben, indem er ihn auf der Seite Admin > 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 Namen Ihres Looker-Servercomputers unterscheidet. Dies ist häufig der Fall, wenn sich Ihre Looker-Installation hinter einem Load Balancer befindet. Wenden Sie sich in diesem Fall an Ihren Looker-Administrator, um den API-Pfad zu erhalten.
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 oder Microsoft Azure gehostet werden, und für Instanzen, die in Amazon Web Service (AWS) gehostet werden und am oder nach dem 07.07.2020 erstellt wurden, wird für den standardmäßigen Looker API-Pfad der Port 443 verwendet. Für Looker-Instanzen, die auf AWS gehostet werden und vor dem 07.07.2020 erstellt wurden, wird für den Standard-Looker API-Pfad 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 für die gewünschte Sprache erstellen. Wir empfehlen die Verwendung eines SDK, da es sich um die Details der Authentifizierung und HTTPS-Anfragen kümmert, sodass Sie die Looker API mit einfachen Funktionsaufrufen aufrufen können.
Details zu SDKs finden Sie auf der Dokumentationsseite Looker API SDKs.
Authentifizierung
Looker authentifiziert API-Anfragen mithilfe eines OAuth 2.0-Inhabertokens im HTTP-Autorisierungsheader der Anfrage. Für alle Looker API-Endpunkte ist eine sichere HTTPS-Verbindung erforderlich, damit das Zugriffstoken während der Übertragung geschützt ist.
Die erforderlichen Schritte 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 die API-Referenzdokumentation ist im Looker Marketplace verfügbar. Weitere Informationen finden Sie auf der Dokumentationsseite APIs Explorer verwenden. Wenn Sie ein Looker-Administrator sind, können Sie auch über die Admin-Seite für die API von Looker auf den API Explorer zugreifen. Klicken Sie dazu auf den Link API Explorer verwenden.
Versionsverwaltung
Die API-Stabilität ist ein wichtiger Aspekt bei der Entwicklung von Anwendungen. Damit Sie besser nachvollziehen können, welche Endpunkte in Zukunft geändert werden könnten und welche stabil bleiben sollten, kennzeichnen wir bestimmte Endpunkte als Beta. Weitere Informationen finden Sie auf der Dokumentationsseite Looker API-Versionsverwaltung.