L'API Looker è un'interfaccia di programmazione di applicazioni "RESTful" sicura per la gestione dell'istanza Looker e il recupero dei dati tramite la piattaforma dati Looker. 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. Puoi fare praticamente qualsiasi cosa nell'applicazione Looker tramite l'API Looker.
Percorso e porta dell'API Looker
Accedi all'API dell'istanza Looker tramite il relativo URL API.
L'amministratore di 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 di Looker può anche utilizzare il campo URL host API per assegnare un percorso API diverso dal nome della macchina del server Looker. Si tratta di un problema comune, ad esempio, quando l'installazione di Looker si trova dietro un bilanciatore del carico. In questo caso, contatta l'amministratore di Looker per ricevere il percorso dell'API.
Se l'amministratore di Looker non ha specificato il campo URL host API, Looker utilizza il percorso API predefinito. Per le istanze di Looker ospitate su Google Cloud, Microsoft Azure e quelle ospitate su Amazon Web Service (AWS) create a partire dal 7/07/2020, il percorso dell'API Looker predefinito utilizza la porta 443. Per le istanze di Looker ospitate su AWS create prima del 7/07/2020, il percorso dell'API Looker predefinito utilizza la porta 19999. L'URL predefinito dell'API ha il seguente formato:
https://<instance_name>.cloud.looker.com:<port>
SDK client
Puoi utilizzare l'API Looker con qualsiasi linguaggio di programmazione o ambiente applicativo in grado di effettuare richieste HTTPS ed elaborare risposte JSON. Puoi creare manualmente le richieste HTTPS dell'API Looker utilizzando curl (o equivalente), tramite l'SDK Ruby di Looker o generando una libreria SDK client per il linguaggio che preferisci. Ti consigliamo di utilizzare un SDK perché si occupa dei dettagli dell'autenticazione e delle richieste HTTPS e ti consente di chiamare l'API Looker utilizzando semplici chiamate di funzione.
Troverai i dettagli relativi all'SDK nella pagina della documentazione relativa agli SDK dell'API Looker.
Autenticazione
Looker autentica le richieste API utilizzando un token di accesso di connessione OAuth 2.0 nell'intestazione di autorizzazione HTTP della richiesta. Tutti gli endpoint dell'API Looker richiedono una connessione HTTPS sicura per garantire la sicurezza del token di accesso durante il transito.
I passaggi per raggiungere questo obiettivo dipendono dall'utilizzo o meno di un SDK. Puoi trovare istruzioni dettagliate nella pagina della documentazione relativa all'autenticazione API Looker.
Documentazione interattiva dell'API
Per la documentazione di riferimento delle API, l'estensione API Explorer è disponibile in Looker Marketplace. Per ulteriori informazioni, consulta la pagina della documentazione relativa all'utilizzo di Explorer API. Se sei un amministratore di Looker, puoi accedere a Explorer API anche facendo clic sul link Utilizza Explorer API nella pagina Amministrazione dell'API 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, contrassegni alcuni endpoint come in versione beta. Per maggiori dettagli, consulta la pagina della documentazione relativa al controllo delle versioni dell'API Looker.