L'API Looker è un ambiente sicuro, "RESTful" un'interfaccia di programmazione di un'applicazione per gestire l'istanza Looker e recuperare 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 di Looker, eseguire query, pianificare l'invio dei dati e così via. Praticamente 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 l'URL dell'API.
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 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 è dietro a 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 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 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 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 le 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 ottenere questo risultato dipendono dall'utilizzo o meno di un SDK. Puoi trovare istruzioni dettagliate nella pagina della documentazione relativa all'autenticazione API Looker.
Documentazione interattiva sull'API
Per la documentazione di riferimento dell'API, l'estensione Explorer API è disponibile in Looker Marketplace. Per saperne di più, consulta la pagina della documentazione Utilizzo di Explorer API. Se sei un amministratore di Looker, puoi anche accedere a Explorer API facendo clic sul link Usa 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.