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 di dati di Looker. Con l'API Looker, puoi scrivere applicazioni o script di automazione per eseguire il provisioning di nuovi account utente di Looker, eseguire query, pianificare l'invio dei dati e così via. Quasi tutto ciò che puoi fare nell'applicazione Looker è possibile tramite l'API Looker.
Percorso e porta dell'API Looker
Accedi all'API dell'istanza di Looker tramite il relativo URL.
L'amministratore di Looker può specificare un percorso dell'API inserendolo nel campo URL dell'host dell'API nella pagina Amministrazione > API nel seguente formato:
https://<instance_name>.cloud.looker.com
L'amministratore di Looker può anche utilizzare il campo URL dell'host dell'API per assegnare un percorso dell'API diverso dal nome della macchina del server Looker. Questo è comune, ad esempio, quando l'installazione di Looker si trova dietro un bilanciatore del carico. In questo caso, contatta l'amministratore di Looker per richiedere il percorso dell'API.
Se l'amministratore di Looker non ha specificato il campo URL dell'host dell'API, Looker utilizza il percorso dell'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 dell'API Looker predefinito utilizza la porta 443. Per le istanze di Looker ospitate su AWS create prima del 07/07/2020, il percorso predefinito dell'API Looker utilizza la porta 19999. L'URL dell'API predefinito 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 di applicazione in grado di effettuare richieste HTTPS ed elaborare risposte JSON. Puoi creare manualmente le 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 delle richieste di autenticazione e HTTPS, in modo da poter chiamare l'API Looker utilizzando semplici chiamate di funzione.
Puoi trovare i dettagli dell'SDK nella pagina della documentazione relativa agli SDK dell'API Looker.
Autenticazione
Looker autentica le richieste API utilizzando un token di accesso con nome intestatario 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 protetto durante il transito.
I passaggi per farlo dipendono dal fatto che tu stia utilizzando o meno un SDK. Puoi trovare istruzioni dettagliate nella pagina della documentazione relativa all'autenticazione API 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 API Explorer. Se sei un amministratore di Looker, puoi accedere a Explorer API anche facendo clic sul link Utilizza Explorer API nella pagina Amministrazione API di Looker.
Controllo delle versioni
La stabilità dell'API è un aspetto importante da considerare durante la creazione di applicazioni. Per aiutarti a capire quali endpoint potrebbero essere modificati in futuro e quali dovrebbero rimanere stabili, contrassegniamo alcuni endpoint come in versione beta. Per ulteriori dettagli, consulta la pagina di documentazione relativa al controllo delle versioni dell'API Looker.