L'API Looker est une interface de programmation d'application sécurisée et "RESTful" qui permet 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. L'API Looker vous permet de faire presque tout ce que vous pouvez faire avec l'API Looker.
Chemin et port de l'API Looker
Accédez à l'API de votre instance Looker via son URL.
Votre administrateur Looker peut spécifier un chemin d'accès à l'API en le saisissant dans le champ URL de l'hôte de l'API sur la page Administration > API, en respectant le 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 de celui de votre serveur Looker. Cette situation est fréquente par exemple lorsque votre installation Looker se trouve derrière un équilibreur de charge. Dans ce cas, contactez votre administrateur Looker pour obtenir votre chemin d'accès à l'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'API par défaut. Pour les instances Looker hébergées sur Google Cloud, Microsoft Azure et les instances hébergées sur Amazon Web Service (AWS) créées le 07/07/2020 ou à une date ultérieure, le chemin d'accès à l'API Looker par défaut utilise le port 443
. Pour les instances Looker hébergées sur AWS créées avant le 07/07/2020, le chemin d'accès à l'API Looker par défaut utilise le port 19999
. L'URL par défaut de l'API est au format suivant:
https://<instance_name>.cloud.looker.com:<port>
Les URL d'API ci-dessus se connectent à la version 4.0 par défaut de l'API. Vous pouvez également vous connecter à la version 3.1 de l'API obsolète en la spécifiant dans l'URL au format
https://<instance_name>.cloud.looker.com:<port>/api/3.1/user
.
SDK client
Vous pouvez utiliser l'API Looker avec n'importe quel langage de programmation ou environnement d'application pouvant effectuer des requêtes HTTPS et traiter des réponses JSON. Vous pouvez créer des requêtes HTTPS pour l'API Looker manuellement à l'aide de curl (ou équivalent), du SDK Ruby Looker 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 s'occupe à votre place des détails de l'authentification et des requêtes HTTPS. Vous pouvez ainsi appeler l'API Looker à l'aide d'appels de fonction simples.
Pour en savoir plus sur les SDK, consultez la page de la documentation concernant les SDK de l'API Looker.
Authentification
Looker authentifie les requêtes API en utilisant un jeton d'accès de 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 pour que le jeton d'accès soit sécurisé en transit.
La procédure à suivre varie selon que vous utilisez ou non un SDK. Des instructions détaillées sont disponibles sur la page Authentification de l'API Looker.
Documentation interactive sur les API
La documentation de référence de l'API est disponible sur Looker Marketplace. Pour en savoir plus, consultez la page de documentation Utiliser l'explorateur d'API. Si vous êtes un administrateur Looker, vous pouvez également accéder à l'explorateur d'API en cliquant sur le lien Utiliser l'explorateur d'API sur la page d'administration API de Looker.
Si vous n'avez pas accès à une instance Looker sur laquelle l'explorateur d'API est installé, vous pouvez afficher une version publique sur le portail des développeurs de Looker.
Gestion des versions
La stabilité des API est un point important à prendre en compte lorsque vous créez des applications. Pour vous aider à identifier les points de terminaison susceptibles d'être modifiés à l'avenir et ceux qui doivent rester stables, nous marquerons certains points de terminaison comme étant en version bêta. Pour en savoir plus, consultez la page de documentation Gestion des versions de l'API Looker.