L'API Looker è un'interfaccia di programmazione di un'applicazione "RESTful" sicura per gestire l'istanza di Looker e recuperare i 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 la distribuzione dei dati e così via. Puoi fare quasi tutto ciò che puoi fare nell'applicazione Looker tramite l'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 URL host API nella 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. Questo è comune quando l'installazione di Looker si trova dietro un bilanciatore del carico, ad esempio. In questo caso, contatta l'amministratore di Looker per ottenere il percorso 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 le istanze ospitate su Amazon Web Service (AWS) create il 07/07/2020 o in data successiva, il percorso API Looker predefinito utilizza la porta 443. Per le istanze di Looker ospitate su AWS create prima del 07/07/2020, il percorso API Looker predefinito utilizza la porta 19999. L'URL API predefinito è nel 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 richieste HTTPS dell'API Looker utilizzando curl (o un equivalente), 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 di autenticazione e delle richieste HTTPS, in modo da poter chiamare l'API Looker utilizzando semplici chiamate di funzioni.
Puoi trovare i dettagli dell'SDK nella pagina della documentazione SDK dell'API Looker.
Autenticazione
Looker autentica le richieste API utilizzando un token di accesso bearer OAuth 2.0 nell'intestazione di autorizzazione HTTP della richiesta. Tutti gli endpoint dell'API Looker richiedono una connessione HTTPS sicura, in modo che il token di accesso sia sicuro durante il trasferimento.
I passaggi per raggiungere questo obiettivo dipendono dall'utilizzo o meno di un SDK. Istruzioni dettagliate sono disponibili nella pagina della documentazione relativa all'autenticazione API di Looker.
Documentazione interattiva dell'API
Per la documentazione di riferimento dell'API, l'estensione Explorer API è disponibile in Looker Marketplace. Per ulteriori informazioni, consulta la pagina della documentazione Utilizzo di Explorer API. Se sei un amministratore di Looker, puoi accedere a Explorer API anche facendo clic sul link Usa Explorer API nella pagina di amministrazione API di Looker.
Controllo delle versioni
La stabilità dell'API è un aspetto importante da considerare quando si creano 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 Controllo delle versioni dell'API Looker.