Erste Schritte mit der Looker API

Die Looker API ist eine sichere „RESTful“-Programmierschnittstelle zur Verwaltung Ihrer Looker-Instanz und zum Abrufen von Daten über die Looker-Datenplattform. Mit der Looker API können Sie Anwendungen oder Automatisierungsskripts schreiben, um neue Looker-Nutzerkonten bereitzustellen, Abfragen auszuführen, Berichte zu planen usw. Über die Looker API haben Sie fast alles, was Sie mit der Looker API tun können.

Looker API-Pfad und Port

Rufen Sie die API der Looker-Instanz über ihre API-URL auf.

Ihr Looker-Administrator kann einen API-Pfad angeben, indem er ihn auf der Seite Admin > API im folgenden Format in das Feld API-Host-URL 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-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 einen 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 auf Amazon Web Service (AWS) gehostet werden und die am oder nach dem 07.07.2020 erstellt wurden, wird für den Standard-Looker API-Pfad 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 Port 19999 verwendet. Die Standard-API-URL hat das folgende Format:

https://<instance_name>.cloud.looker.com:<port>

Die oben aufgeführten API-URLs stellen eine Verbindung zur API-Standardversion 4.0 her. Sie können auch eine Verbindung zur eingestellten API-Version 3.1 herstellen, indem Sie sie in der URL im Format https://<instance_name>.cloud.looker.com:<port>/api/3.1/user angeben.

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 Looker API-HTTPS-Anfragen manuell mit dem Befehl „curl“ (oder einem ähnlichen Tool) oder mit dem Looker Ruby SDK oder durch Generieren einer Clientbibliothek für die Sprache Ihrer Wahl erstellen. Wir empfehlen die Verwendung eines SDK, da dieses die Authentifizierung und die HTTPS-Anfragen für Sie übernimmt, sodass Sie die Looker API mit einfachen Funktionsaufrufen aufrufen können.

SDK-Details finden Sie auf der Dokumentationsseite zu den Looker API SDKs.

Authentifizierung

Looker authentifiziert API-Anfragen mithilfe eines OAuth 2.0-Inhabertokens im HTTP-Autorisierungsheader der Anfrage. Alle Looker API-Endpunkte erfordern eine sichere HTTPS-Verbindung, damit das Zugriffstoken während der Übertragung sicher ist.

Die dafür erforderlichen Schritte hängen davon ab, ob Sie ein SDK verwenden. Eine ausführliche Anleitung finden Sie auf der Dokumentationsseite zur Looker API-Authentifizierung.

Interaktive API-Dokumentation

Als API-Referenzdokumentation ist die Erweiterung „API Explorer“ im Looker Marketplace verfügbar. Weitere Informationen finden Sie auf der Dokumentationsseite API Explorer verwenden. Als Looker-Administrator können Sie auch auf den API Explorer zugreifen, indem Sie auf der Looker-Seite API Admin auf den Link API Explorer verwenden klicken.

Wenn Sie keinen Zugriff auf eine Looker-Instanz haben, auf der der API Explorer installiert ist, können Sie eine öffentliche Version im Looker-Entwicklerportal ansehen.

Versionsverwaltung

Die API-Stabilität spielt beim Erstellen von Anwendungen eine wichtige Rolle. Damit Sie besser nachvollziehen können, welche Endpunkte in Zukunft geändert werden können und stabil bleiben sollen, kennzeichnen wir bestimmte Endpunkte als Betaversion. Weitere Informationen finden Sie auf der Dokumentationsseite zur Looker API-Versionsverwaltung.