Die Looker-API ist eine sichere RESTful-Anwendungsprogrammierschnittstelle, mit der Sie Ihre Looker-Instanz verwalten und Daten über die Looker-Datenplattform abrufen können. Mit der Looker-API können Sie Anwendungen oder Automatisierungsskripts schreiben, um neue Looker-Benutzerkonten bereitzustellen, Abfragen auszuführen, Berichte zu planen usw. Fast alles, was Sie in der Looker-Anwendung tun können, können Sie über die Looker-API tun.
Pfad und Port der Looker API
Greifen Sie über deren API-URL auf die API Ihrer Looker-Instanz zu.
Ihr Looker-Administrator kann einen API-Pfad angeben, indem er ihn im Feld API-Host-URL auf der Seite Admin > API 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 des Looker-Servercomputers unterscheidet. Das kommt beispielsweise häufig vor, wenn sich Ihre Looker-Installation hinter einem Load-Balancer befindet. Wenden Sie sich in diesem Fall an Ihren Looker-Administrator, um Ihren 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 auf Amazon Web Service (AWS) gehostet werden und am oder nach dem 07.07.2020 erstellt wurden, verwendet der standardmäßige Looker API-Pfad Port 443. Für auf AWS gehostete Looker-Instanzen, die vor dem 07.07.2020 erstellt wurden, verwendet der standardmäßige Looker API-Pfad Port 19999. 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 senden und JSON-Antworten verarbeiten kann. Sie können HTTPS-Anfragen für die Looker API manuell erstellen, indem Sie curl (oder gleichwertig) verwenden, das Looker Ruby SDK verwenden oder eine Clientbibliothek für die Sprache Ihrer Wahl generieren. Wir empfehlen die Verwendung eines SDK, da es sich um die Details der Authentifizierung und HTTPS-Anfragen kümmert, sodass Sie die Looker-API mithilfe einfacher Funktionsaufrufe aufrufen können.
Weitere Informationen zu SDKs finden Sie auf der Dokumentationsseite Looker API SDKs.
Authentifizierung
Looker authentifiziert API-Anfragen mithilfe eines OAuth 2.0-Inhaberzugriffstokens im HTTP-Autorisierungsheader der Anfrage. Alle Looker API-Endpunkte benötigen eine sichere HTTPS-Verbindung, damit das Zugriffstoken bei der Übertragung sicher ist.
Die Schritte zum Erreichen dieses Ziels hängen davon ab, ob Sie ein SDK verwenden oder nicht. Eine ausführliche Anleitung finden Sie auf der Dokumentationsseite zur Looker API-Authentifizierung.
Dokumentation zur interaktiven API
Die API-Referenzdokumentation finden Sie im Looker Marketplace. Weitere Informationen finden Sie auf der Dokumentationsseite API Explorer verwenden. Wenn Sie ein Looker-Administrator sind, können Sie auch auf den API Explorer zugreifen, indem Sie auf der Seite API-Verwaltung von Looker auf den Link API Explorer verwenden klicken.
Versionsverwaltung
Die API-Stabilität ist ein wichtiger Faktor beim Erstellen von Anwendungen. Damit Sie besser verstehen, welche Endpunkte in Zukunft geändert werden können und welche stabil bleiben sollten, kennzeichnen wir bestimmte Endpunkte als in der Betaphase. Weitere Informationen finden Sie auf der Dokumentationsseite Looker API-Versionsverwaltung.