Die Looker API ist eine sichere, RESTful App, 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-Nutzerkonten bereitzustellen, Abfragen auszuführen, Berichte zu planen usw. Sie können also fast alles tun, was Sie in der Looker API tun können.
Pfad und Port der Looker API
Greifen Sie über die API-URL auf die API der Looker-Instanz zu.
Ihr Looker-Administrator kann einen API-Pfad angeben. Geben Sie ihn dazu in das Feld API-Host-URL auf der Seite Admin &API in einem der folgenden Formate ein:
https://<instance_name>.api.looker.com
oder:
https://<instance_name>.api.<my_region>.looker.com
oder:
https://<instance_name>.looker.com
Ihr Looker-Administrator kann dem Feld API-Host-URL auch einen API-Pfad zuweisen, der sich vom Namen des Looker-Servercomputers unterscheidet. Dies ist beispielsweise der Fall, wenn sich die Looker-Installation hinter einem Load-Balancer befindet. Wenden Sie sich in diesem Fall an Ihren Looker-Administrator für Ihren API-Pfad.
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 am oder nach dem 7. Juli 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>.looker.com:<port>
Die oben aufgeführten API-URLs stellen eine Verbindung zur API-Standardversion 3.1 her. Sie können auch eine Verbindung zur verworfenen API-Version 3.0 herstellen, indem Sie sie in der URL im Format
https://<instance_name>.looker.com:<port>/api/3.0/useroderhttps://<instance_name>.api.looker.com/api/3.0/userangeben.
Client-SDKs
Sie können die Looker API mit jeder Programmiersprache und Anwendungsumgebung verwenden, die HTTPS-Anfragen senden und JSON-Antworten verarbeiten können. Sie können die Looker API-HTTPS-Anfragen manuell mit „curl“ (oder einer gleichwertigen Funktion), mit dem Looker Ruby SDK oder durch Generieren einer Client SDK-Bibliothek für die Sprache Ihrer Wahl erstellen. Wir empfehlen die Verwendung eines SDK, da dieses die Details der Authentifizierung und HTTPS-Anfragen für Sie übernimmt, sodass Sie die Looker API mit einfachen Funktionsaufrufen aufrufen können.
Details zu den SDKs finden Sie auf der Dokumentationsseite zu den Looker API SDKs.
Authentifizierung
Looker authentifiziert API-Anfragen mithilfe eines OAuth 2.0-Inhaber-Zugriffstokens im HTTP-Autorisierungsheader der Anfrage. Alle Looker API-Endpunkte erfordern eine sichere HTTPS-Verbindung, damit das Zugriffstoken bei der Übertragung sicher ist.
Die dafür erforderlichen Schritte hängen davon ab, ob Sie ein SDK verwenden. Ausführliche Informationen finden Sie auf der Dokumentationsseite für die Looker API-Authentifizierung.
Interaktive API-Dokumentation
Die API Explorer-Referenzdokumentation ist für die API Explorer-Erweiterung im Looker Marketplace verfügbar. 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 den Link API Explorer verwenden auf der API-Administratorseite von Looker klicken.
Wenn Sie keinen Zugriff auf eine Looker-Instanz haben, auf der API Explorer installiert ist, können Sie eine öffentliche Version im Entwicklerportal von Looker aufrufen.
Versionsverwaltung
Die API-Stabilität ist ein wichtiger Aspekt, wenn Sie Anwendungen erstellen. Damit Sie besser nachvollziehen können, welche Endpunkte in der Zukunft geändert werden können und welche stabil bleiben sollen, kennzeichnen wir bestimmte Endpunkte in der Betaphase. Weitere Informationen finden Sie auf der Dokumentationsseite Looker API-Versionsverwaltung.