Erste Schritte mit der Looker API

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 Automatisierungsskripts erstellen, um neue Looker-Nutzerkonten bereitzustellen, Abfragen auszuführen, Datenlieferungen 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

Sie können über die API-URL auf die API Ihrer Looker-Instanz zugreifen.

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 das Feld API-Host-URL auch verwenden, um einen API-Pfad zuzuweisen, der sich vom Namen Ihres Looker-Servers unterscheidet. Dies 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 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, Microsoft Azure und in Amazon Web Service (AWS) gehostet werden und am oder nach dem 07.07.2020 erstellt wurden, verwendet der Standard-Looker-API-Pfad den Port 443. Für Looker-Instanzen, die in AWS gehostet werden und vor dem 07.07.2020 erstellt wurden, verwendet der Standard-Looker API-Pfad den 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 stellen und JSON-Antworten verarbeiten kann. Sie können Looker API-HTTPS-Anfragen manuell mit curl (oder einer entsprechenden Funktion), mit dem Looker Ruby SDK oder durch Generieren einer Client-SDK-Bibliothek für Ihre bevorzugte 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 unserer Dokumentationsseite zu Looker API-SDKs.

Authentifizierung

Looker authentifiziert API-Anfragen mit einem OAuth 2.0-Bearer-Zugriffstoken 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 hierzu hängen davon ab, ob Sie ein SDK verwenden oder nicht. Eine detaillierte Anleitung finden Sie auf unserer Dokumentationsseite zur Looker API-Authentifizierung.

Interaktive API-Dokumentation

Für die API-Referenzdokumentation ist die API Explorer-Erweiterung im Looker Marketplace verfügbar. Weitere Informationen finden Sie auf der Dokumentationsseite API Explorer verwenden. Wenn Sie Looker-Administrator sind, können Sie auch auf den API Explorer zugreifen, indem Sie auf der Looker-Seite "Verwaltung" API auf den Link API Explorer verwenden klicken.

Versionsverwaltung

Die API-Stabilität ist ein wichtiger Aspekt beim Erstellen von Anwendungen. Damit Sie wissen, welche Endpunkte in Zukunft geändert werden können und welche stabil bleiben sollten, kennzeichnen wir bestimmte Endpunkte als Beta. Weitere Informationen finden Sie auf der Dokumentationsseite zur Looker API-Versionsverwaltung.