L'API Looker è un'interfaccia di programmazione di applicazioni sicura e "restful" per gestire la tua istanza di Looker e recuperare dati tramite la piattaforma dati di 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. praticamente tutto ciò che puoi fare nell'applicazione Looker, grazie all'API Looker.
Percorso e porta dell'API Looker
Accedi all'API dell'istanza di Looker tramite il relativo URL API.
L'amministratore di Looker può specificare un percorso API inserendolo nel campo API Host URL (URL host API) della pagina Admin > API ( uno dei seguenti formati):
https://<instance_name>.api.looker.com
oppure:
https://<instance_name>.api.<my_region>.looker.com
oppure:
https://<instance_name>.looker.com
L'amministratore di Looker può anche utilizzare il campo URL host API per assegnare un percorso API diverso dal nome della macchina sul server Looker. Questa situazione è comune quando l'installazione di Looker è protetta da un bilanciatore del carico, ad esempio. In questo caso, contatta l'amministratore di Looker per richiedere il percorso API.
Se l'amministratore di Looker non ha specificato il campo API Host URL (URL host API), Looker utilizza il percorso API predefinito. Per le istanze Looker ospitate su Google Cloud, Microsoft Azure e quelle ospitate su Amazon Web Service (AWS) create il 07/07/2020 o in 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 predefinito dell'API Looker utilizza la porta 19999. L'URL API predefinito è nel seguente formato:
https://<instance_name>.looker.com:<port>
Gli URL delle API riportate sopra si connettono alla versione predefinita dell'API 3.1. Puoi anche collegarti alla versione 3.0 dell'API deprecata specificandola nell'URL con il formato
https://<instance_name>.looker.com:<port>/api/3.0/userohttps://<instance_name>.api.looker.com/api/3.0/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 SDK client per il linguaggio che preferisci. Consigliamo di utilizzare un SDK perché si occupa dei dettagli di autenticazione e delle richieste HTTPS, in modo che tu possa chiamare l'API Looker utilizzando semplici chiamate di funzione.
I dettagli dell'SDK sono disponibili nella pagina della documentazione dedicata agli SDK dell'API Looker.
Autenticazione
Looker autentica le richieste API utilizzando un token di accesso al connessione 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 varia a seconda che tu stia utilizzando o meno un SDK. Istruzioni dettagliate sono disponibili nella pagina della documentazione relativa all'autenticazione dell'API Looker.
Documentazione dell'API interattiva
Per la documentazione di riferimento dell'API, l'estensione Explorer API è disponibile in Looker Marketplace. Per ulteriori informazioni, consulta la pagina della documentazione dedicata all'utilizzo dell'Explorer API. Se sei un amministratore di Looker, puoi anche accedere all'API Explorer facendo clic sul link Use API Explorer (Utilizza API Explorer) nella pagina di amministrazione dell'API di Looker.
Se non hai accesso a un'istanza di Looker su cui è installato Explorer API, puoi visualizzare una versione pubblica sul portale per sviluppatori di Looker.
Controllo delle versioni
La stabilità delle API è un fattore importante durante la creazione delle applicazioni. Per aiutarti a capire quali endpoint potrebbero essere modificati in futuro e quali dovrebbero rimanere stabili, alcuni endpoint sono contrassegnati come beta. Per ulteriori dettagli, consulta la pagina della documentazione relativa al controllo delle versioni dell'API Looker.