L'API Looker est une interface de programmation d'application "RESTful" et sécurisée permettant de gérer votre instance Looker et d'extraire des données via la plate-forme de données Looker. Avec l'API Looker, vous pouvez écrire des applications ou des scripts d'automatisation pour provisionner de nouveaux comptes utilisateur Looker, exécuter des requêtes, planifier des rapports, etc. À peu près tout ce que vous pouvez faire dans l'application Looker via l'API Looker.
Chemin d'accès et port de l'API Looker
Accédez à l'API de votre instance Looker via son URL d'API.
Votre administrateur Looker peut spécifier un chemin d'API en le saisissant dans le champ URL de l'hôte de l'API de la page Admin > API au format suivant:
https://<instance_name>.cloud.looker.com
Votre administrateur Looker peut également utiliser le champ URL de l'hôte de l'API pour attribuer un chemin d'accès à l'API différent du nom de la machine du serveur Looker. Ce problème est courant lorsque votre installation Looker se trouve derrière un équilibreur de charge, par exemple. Dans ce cas, contactez votre administrateur Looker pour obtenir votre chemin d'API.
Si votre administrateur Looker n'a pas spécifié le champ URL de l'hôte de l'API, Looker utilise le chemin d'accès à l'API par défaut. Pour les instances Looker hébergées sur Google Cloud ou Microsoft Azure, ainsi que celles hébergées sur Amazon Web Service (AWS) créées à partir du 07/07/2020, le chemin d'accès à l'API Looker par défaut utilise le port 443. Pour les instances Looker hébergées sur AWS et créées avant le 07/07/2020, le chemin d'accès à l'API Looker par défaut utilise le port 19999. L'URL de l'API par défaut est au format suivant:
https://<instance_name>.cloud.looker.com:<port>
SDK client
Vous pouvez utiliser l'API Looker avec n'importe quel langage de programmation ou environnement d'application capable d'effectuer des requêtes HTTPS et de traiter des réponses JSON. Vous pouvez créer des requêtes HTTPS de l'API Looker manuellement en utilisant curl (ou équivalent), à l'aide du SDK Looker Ruby ou en générant une bibliothèque SDK client pour le langage de votre choix. Nous vous recommandons d'utiliser un SDK, car il gère à votre place les détails de l'authentification et des requêtes HTTPS, ce qui vous permet d'appeler l'API Looker via de simples appels de fonction.
Pour en savoir plus sur les SDK, consultez notre page de documentation sur les SDK des API Looker.
Authentification
Looker authentifie les requêtes API en utilisant un jeton d'accès au support OAuth 2.0 dans l'en-tête d'autorisation HTTP de la requête. Tous les points de terminaison de l'API Looker nécessitent une connexion HTTPS sécurisée afin que le jeton d'accès soit sécurisé en transit.
La procédure à suivre varie selon que vous utilisez ou non un SDK. Pour obtenir des instructions détaillées, consultez la page de documentation sur l'authentification via l'API Looker.
Documentation interactive de l'API
Pour accéder à la documentation de référence de l'API, l'extension APIs Explorer est disponible sur Looker Marketplace. Pour en savoir plus, consultez la page de documentation Utiliser l'explorateur d'API. Si vous êtes administrateur Looker, vous pouvez également accéder à l'explorateur d'API en cliquant sur le lien Utiliser l'explorateur d'API sur la page Administration des API de Looker.
Gestion des versions
La stabilité des API est un élément important à prendre en compte lors de la création d'applications. Pour vous aider à comprendre quels points de terminaison peuvent être modifiés à l'avenir et lesquels devraient rester stables, nous avons marqué certains points de terminaison comme étant en version bêta. Pour en savoir plus, consultez la page de documentation sur la gestion des versions de l'API Looker.