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, puede escribir aplicaciones o secuencias de comandos de automatización para aprovisionar cuentas de usuario de Looker nuevas, ejecutar consultas, programar informes, etc. Prácticamente todo lo que puede hacer en la aplicación de Looker puede hacer mediante la API de Looker.
Puerto y ruta de acceso de la API de Looker
Accede a la API de tu instancia de Looker mediante la URL de la API.
El administrador de Looker puede especificar una ruta de acceso de la API ingresándola en el campo URL del host de la API de la página API de administración en uno de los siguientes formatos:
https://<instance_name>.api.looker.com
o:
https://<instance_name>.api.<my_region>.looker.com
o:
https://<instance_name>.looker.com
Tu administrador de Looker también puede usar el campo URL del host de la API para asignar una ruta de API que sea diferente del nombre de tu 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 el administrador de Looker para obtener la ruta de acceso de la API.
Si tu administrador de Looker no especificó el campo URL del host de la API, Looker usará la ruta de acceso de la API predeterminada. Para las instancias de Looker alojadas en Google Cloud, Microsoft Azure y las instancias alojadas en Amazon Web Service (AWS) que se crearon el 07/07/2020 o después, 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 7 de julio de 2020, la ruta predeterminada de la API de Looker usa el puerto 19999. La URL predeterminada de la API tiene el siguiente formato:
https://<instance_name>.looker.com:<port>
Las URL de API anteriores se conectan a la versión de API predeterminada 3.1. También puedes conectarte a la versión 3.0 de la API obsoleta si la especificas en la URL con el formato
https://<instance_name>.looker.com:<port>/api/3.0/userohttps://<instance_name>.api.looker.com/api/3.0/user.
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 de la API de Looker de forma manual con curl (o equivalente), mediante el SDK de Looker para Ruby o generando una biblioteca del SDK del cliente según tu lenguaje preferido. Recomendamos usar 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 de función simples.
Encontrarás detalles del SDK en nuestra página de documentación de los SDK de la API de Looker.
Authentication
Looker autentica las solicitudes a la API mediante 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 esté protegido en tránsito.
Los pasos para lograrlo dependen de si usa o no un SDK. Puedes encontrar instrucciones detalladas en nuestra página de documentación de la autenticación de API de Looker.
Documentación de la API interactiva
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 Usa el Explorador de API. Si eres administrador de Looker, también puedes acceder al Explorador de API si haces clic en el vínculo Usar el Explorador de API en la página de Administrador de la API de Looker.
Si no tienes acceso a una instancia de Looker en la que está instalado el Explorador de API, puedes ver una versión pública en el Portal para desarrolladores de Looker.
Control de versiones
La estabilidad de la API es una consideración importante cuando se compilan aplicaciones. Para ayudarte a comprender qué extremos pueden cambiar en el futuro y cuáles deben permanecer estables, marcamos que algunos extremos 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.