L'API Looker est une interface de programmation d'applications RESTful sécurisée permettant de gérer l'instance Looker et d'extraire des données via la plate-forme de données Looker. Avec cette API, vous pouvez écrire des applications ou des scripts d'automatisation pour créer de nouveaux comptes utilisateur Looker, exécuter des requêtes, planifier des livraisons de données, etc. Quasiment toutes les tâches réalisables dans l'application Looker s'effectuent 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'accès à l'API en le saisissant dans le champ API Host URL de la page Admin > API au format suivant :
https://<instance_name>.cloud.looker.com
Votre administrateur Looker peut également utiliser le champ API Host URL (URL de l'hôte de l'API) pour attribuer un chemin d'accès à l'API différent du nom de la machine de votre serveur Looker. Cela 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'accès à l'API.
Si votre administrateur Looker n'a pas spécifié le champ API Host URL (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, Microsoft Azure et les instances hébergées sur Amazon Web Service (AWS) créées le 7 juillet 2020 ou après, 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 7 juillet 2020, le chemin d'accès à l'API Looker par défaut utilise le port 19999. L'URL de l'API par défaut se présente comme suit :
https://<instance_name>.cloud.looker.com:<port>
SDK clients
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 manuellement des requêtes HTTPS d'API Looker à l'aide de curl (ou d'un équivalent), à l'aide du SDK Ruby Looker ou en générant une bibliothèque de SDK client pour le langage de votre choix. Nous vous recommandons d'utiliser un SDK, car il gère les détails de l'authentification et des requêtes HTTPS pour vous. Vous pouvez ainsi appeler l'API Looker à l'aide d'appels de fonction simples.
Vous trouverez des informations sur les SDK sur la page de documentation SDK de l'API Looker.
Authentification
Looker authentifie les requêtes API à l'aide d'un jeton d'accès porteur 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.
Les étapes à suivre dépendent de l'utilisation ou non d'un SDK. Vous trouverez des instructions détaillées sur la page de documentation sur l'authentification de l'API Looker.
Documentation interactive sur l'API
Pour la documentation de référence de l'API, l'extension Explorateur d'API est disponible sur le Marketplace Looker. 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 Use API Explorer (Utiliser l'explorateur d'API) sur la page d'administration API de Looker.
Gestion des versions
La stabilité de l'API est un critère important lors de la création d'applications. Pour vous aider à comprendre quels points de terminaison peuvent être modifiés à l'avenir et lesquels doivent rester stables, nous marquons 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 .