La API de Looker es una herramienta segura y “RESTful” interfaz de programación de aplicaciones 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 nuevas cuentas de usuario de Looker, ejecutar consultas, programar informes, etcétera. Casi todo lo que se puede hacer en la aplicación de Looker se puede realizar con la API de Looker.
Ruta y puerto de la API de Looker
Accede a la API de tu instancia de Looker a través de la URL de su API.
El administrador de Looker puede especificar una ruta de acceso a la API ingresándola en el campo URL del host de la API en Administrador > API en el siguiente formato:
https://<instance_name>.cloud.looker.com
El administrador de Looker también puede usar el campo URL del host de la API para asignar una ruta de acceso a la API diferente del nombre de máquina del servidor de Looker. Esto es común cuando la instalación de Looker está detrás de un balanceador de cargas, por ejemplo. En este caso, comunícate con tu administrador de Looker para obtener información sobre 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. Para 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 predeterminada de la API de Looker usa el puerto 443. Para las instancias de Looker alojadas en AWS que se crearon antes del 07/07/2020, la ruta predeterminada a 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 aplicaciones que pueda realizar solicitudes HTTPS y procesar respuestas JSON. Puedes crear solicitudes HTTPS de la API de Looker de forma manual con curl (o equivalente), usando el SDK de Looker Ruby o generando una biblioteca de SDK cliente para el lenguaje que elijas. Te recomendamos que uses un SDK porque se encarga de los detalles de la autenticación y las solicitudes HTTPS para que puedas llamar a la API de Looker con llamadas a funciones simples.
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 del 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 permanezca protegido en tránsito.
Los pasos para lograr esto dependen de si usas o no un SDK. Puedes encontrar instrucciones detalladas en nuestra página de documentación de autenticación de la API de Looker.
Documentación de la API interactiva
Para ver la documentación de referencia de la API, la extensión del Explorador de APIs está disponible en Looker Marketplace. Para obtener más información, consulta la página de documentación Cómo usar el Explorador de APIs. Si eres administrador de Looker, también puedes acceder al Explorador de APIs haciendo clic en el vínculo Usar el Explorador de APIs en la página Administrador de API de Looker.
Control de versiones
La estabilidad de la API es una consideración importante cuando se compilan aplicaciones. Para ayudarlo a comprender qué extremos pueden cambiar en el futuro y cuáles deberían permanecer estables, marcamos ciertos extremos como que están en versión beta. Para obtener más detalles, consulta la página de documentación del control de versiones de la API de Looker.