La API de Looker es una interfaz de programación de aplicaciones segura y “RESTful” para administrar tu instancia de Looker y recuperar datos a través de la plataforma de datos de Looker. Con la API de Looker, puedes escribir aplicaciones o secuencias de comandos de automatización para aprovisionar cuentas de usuario nuevas de Looker, ejecutar consultas, programar entregas de datos, etcétera. Casi todo lo que puedes hacer en la aplicación de Looker lo puedes hacer a través de la API de Looker.
Ruta de acceso y puerto de la API de Looker
Accede a la API de tu instancia de Looker a través de su URL de API.
Tu administrador de Looker puede especificar una ruta de API ingresándola en el campo URL del host de la API en la página Administrador > API con el siguiente formato:
https://<instance_name>.cloud.looker.com
Es posible que el administrador de Looker también use el campo URL del host de la API para asignar una ruta de API diferente del nombre de la máquina del servidor de Looker. Esto es común cuando tu instalación de Looker se encuentra detrás de un balanceador de cargas, por ejemplo. En este caso, comunícate con tu administrador de Looker para obtener la ruta de acceso a la API.
Si tu administrador de Looker no especificó el campo URL del host de la API, Looker usará la ruta de acceso predeterminada de la API. En el caso de las instancias de Looker alojadas en Google Cloud, Microsoft Azure y las instancias alojadas en Amazon Web Service (AWS) que se crearon a partir del 07/07/2020, la ruta de acceso predeterminada de la API de Looker usa el puerto 443. En el caso de las instancias de Looker alojadas en AWS que se crearon antes del 7/7/2020, la ruta de acceso predeterminada de la API de Looker usa el puerto 19999. La URL de la API predeterminada tiene el siguiente formato:
https://<instance_name>.cloud.looker.com:<port>
SDK cliente
Puedes usar la API de Looker con cualquier lenguaje de programación o entorno de aplicación que pueda realizar solicitudes HTTPS y procesar respuestas JSON. Puedes crear solicitudes HTTPS a la API de Looker de forma manual con curl (o un equivalente), con el SDK de Ruby de Looker o generando una biblioteca del SDK cliente para el lenguaje que elijas. Te recomendamos que uses un SDK, ya que se encarga de los detalles de la autenticación y las solicitudes HTTPS por ti, de modo que puedas llamar a la API de Looker con simples llamadas a funciones.
Encontrarás los detalles del SDK en nuestra página de documentación de los SDKs de la API de Looker.
Autenticación
Looker autentica las solicitudes a la API con un token de acceso de portador de OAuth 2.0 en el encabezado de autorización HTTP de la solicitud. Todos los extremos de la API de Looker requieren una conexión HTTPS segura para que el token de acceso esté seguro durante la transmisión.
Los pasos para lograr esto dependen de si usas un SDK. Puedes encontrar instrucciones detalladas en nuestra página de documentación sobre la autenticación de la API de Looker.
Documentación interactiva de la API
Para la documentación de referencia de la API, la extensión del Explorador de API está disponible en Looker Marketplace. Para obtener más información, consulta la página de documentación Cómo usar API Explorer. Si eres administrador de Looker, también puedes acceder al Explorador de API haciendo clic en el vínculo Usar el Explorador de API en la página de administrador de la API de Looker.
Control de versiones
La estabilidad de la API es un factor importante a tener en cuenta cuando se compilan aplicaciones. Para ayudarte a comprender qué extremos pueden cambiar en el futuro y cuáles deberían permanecer estables, marcamos ciertos extremos como en versión beta. Para obtener más detalles, consulta la página de documentación sobre el control de versiones de la API de Looker.