L'API Looker è un'interfaccia di programmazione sicura dell'applicazione "RESTful" per gestire l'istanza di Looker e recuperare i dati tramite la piattaforma dati. Con l'API Looker puoi scrivere applicazioni o script di automazione per eseguire il provisioning di nuovi account utente Looker, eseguire query, pianificare report e così via. In pratica, puoi fare tutto nell'applicazione Looker tramite l'API Looker.
Percorso e porta API Looker
Accedi all'API dell'istanza di Looker tramite il relativo URL API.
L'amministratore Looker può specificare un percorso API inserendolo nel campo URL host API della pagina Amministrazione > API nel seguente formato:
https://<instance_name>.cloud.looker.com
L'amministratore Looker può anche utilizzare il campo URL host API per assegnare un percorso API diverso dal nome della macchina server Looker. Questo si verifica di solito quando l'installazione di Looker è dietro un bilanciatore del carico, ad esempio. In questo caso, contatta il tuo amministratore Looker per il tuo percorso API.
Se l'amministratore Looker non ha specificato il campo URL host API, Looker utilizza il percorso API predefinito. Per le istanze Looker ospitate su Google Cloud, Microsoft Azure e le istanze ospitate su Amazon Web Service (AWS) create il 07/07/2020 o in una data successiva, il percorso API predefinito di Looker utilizza la porta 443. Per le istanze Looker ospitate su AWS create prima del 07/07/2020, il percorso API predefinito di Looker utilizza la porta 19999. L'URL API predefinito è nel seguente formato:
https://<instance_name>.cloud.looker.com:<port>
Gli URL API indicati sopra si connettono alla versione API predefinita 4.0. Puoi collegarti alla versione API deprecata 3.1 anche specificandola nell'URL con il formato
https://<instance_name>.cloud.looker.com:<port>/api/3.1/user.
SDK client
Puoi utilizzare l'API Looker con qualsiasi linguaggio di programmazione o ambiente applicativo in grado di eseguire richieste HTTPS ed elaborare risposte JSON. Puoi creare manualmente le richieste HTTPS dell'API Looker utilizzando curl (o equivalente), utilizzando l'SDK Ruby di Looker o generando una libreria dell'SDK client per il linguaggio che preferisci. Consigliamo di utilizzare un SDK perché si occupa dei dettagli dell'autenticazione e delle richieste HTTPS, al fine di poter chiamare l'API Looker utilizzando semplici chiamate di funzione.
I dettagli dell'SDK sono disponibili nella pagina della documentazione relativa agli SDK dell'API Looker.
Autenticazione
Looker autentica le richieste API utilizzando un token di accesso al portatore OAuth 2.0 nell'intestazione dell'autorizzazione HTTP della richiesta. Tutti gli endpoint dell'API Looker richiedono una connessione HTTPS sicura in modo che il token di accesso sia protetto in transito.
La procedura per ottenere questo risultato dipende dal fatto che tu stia utilizzando o meno un SDK. Per istruzioni dettagliate, consulta la pagina della documentazione relativa all'autenticazione delle API Looker.
Documentazione dell'API interattiva
Per la documentazione Riferimento API, l'estensione Explorer API è disponibile su Looker Marketplace. Per ulteriori informazioni, consulta la pagina della documentazione Utilizzo di Explorer API. Se sei un amministratore Looker, puoi accedere ad Explorer API anche facendo clic sul link Utilizza Explorer API nella pagina di amministrazione delle API di Looker.
Se non hai accesso a un'istanza di Looker su cui è installato Explorer API, puoi visualizzare una versione pubblica sul portale sviluppatori di Looker.
Controllo delle versioni
La stabilità delle API è una considerazione importante durante la creazione delle applicazioni. Per aiutarti a capire quali endpoint potrebbero essere modificati in futuro e quali dovrebbero rimanere stabili, contrassegniamo alcuni endpoint come beta. Per maggiori dettagli, consulta la pagina della documentazione relativa al controllo delle versioni dell'API Looker.