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 Automatisierungsscripts 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 auch über die Looker API tun.
Pfad und Port der Looker API
Rufen Sie die API Ihrer Looker-Instanz über die API-URL auf.
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 auch das Feld API-Host-URL verwenden, um einen API-Pfad zuzuweisen, der sich vom Computernamen des 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 den API-Pfad zu erfahren.
Wenn Ihr Looker-Administrator das Feld API-Host-URL nicht angegeben hat, verwendet Looker den Standard-API-Pfad. Bei 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 standardmäßigen Looker API-Pfad Port 443 verwendet. Für Looker-Instanzen, die auf AWS gehostet und vor dem 07.07.2020 erstellt wurden, wird für den Standardpfad der Looker API der Port 19999 verwendet. Die API-Standard-URL hat folgendes 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 in Ihrer bevorzugten Sprache erstellen. Wir empfehlen die Verwendung eines SDKs, da es die Details der Authentifizierung und HTTPS-Anfragen für Sie übernimmt, sodass Sie die Looker API mit einfachen Funktionsaufrufen aufrufen können.
Details zum SDK finden Sie auf der Dokumentationsseite für die Looker API SDKs.
Authentifizierung
Looker authentifiziert API-Anfragen mit einem OAuth 2.0-Inhaberzugriffstoken im HTTP-Autorisierungsheader der Anfrage. Alle Looker-API-Endpunkte erfordern eine sichere HTTPS-Verbindung, damit das Zugriffstoken bei der Übertragung sicher ist.
Die dazu erforderlichen Schritte hängen davon ab, ob Sie ein SDK verwenden oder nicht. Eine ausführliche Anleitung finden Sie auf der Dokumentationsseite für die 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 über den Link API Explorer verwenden auf der Seite API auf den API Explorer zugreifen.
Versionsverwaltung
Die API-Stabilität spielt beim Erstellen von Anwendungen eine wichtige Rolle. Damit Sie besser nachvollziehen können, welche Endpunkte in Zukunft möglicherweise geändert werden und welche stabil bleiben sollten, kennzeichnen wir bestimmte Endpunkte als Beta. Weitere Informationen finden Sie auf der Dokumentationsseite zur Looker API-Versionsverwaltung.