A API Looker é uma interface de programação de aplicações "RESTful" segura para gerir a sua instância do Looker e obter dados através da plataforma de dados do Looker. Com a API Looker, pode escrever aplicações ou scripts de automatização para aprovisionar novas contas de utilizador do Looker, executar consultas, agendar entregas de dados, etc. Praticamente tudo o que pode fazer na aplicação Looker, pode fazê-lo através da API Looker.
Caminho e porta da API Looker
Aceda à API da sua instância do Looker através do URL da API.
O administrador do Looker pode especificar um caminho da API introduzindo-o no campo URL do anfitrião da API na página Administração > API no seguinte formato:
https://<instance_name>.cloud.looker.com
O administrador do Looker também pode usar o campo URL do anfitrião da API para atribuir um caminho da API diferente do nome do computador do servidor do Looker. Isto é comum quando a instalação do Looker está atrás de um balanceador de carga, por exemplo. Neste caso, contacte o administrador do Looker para saber o caminho da API.
Se o administrador do Looker não tiver especificado o campo URL do anfitrião da API, o Looker usa o caminho da API predefinido. Para instâncias do Looker alojadas no Google Cloud, no Microsoft Azure e instâncias alojadas no Amazon Web Service (AWS) criadas a 07/07/2020 ou após esta data, o caminho da API Looker predefinido usa a porta 443. Para instâncias do Looker alojadas na AWS criadas antes de 07/07/2020, o caminho da API Looker predefinido usa a porta 19999. O URL da API predefinido tem o seguinte formato:
https://<instance_name>.cloud.looker.com:<port>
SDKs do cliente
Pode usar a API Looker com qualquer linguagem de programação ou ambiente de aplicação que possa fazer pedidos HTTPS e processar respostas JSON. Pode criar pedidos HTTPS da API Looker manualmente através do curl (ou equivalente), através do SDK Ruby do Looker ou gerando uma biblioteca de SDK do cliente para a sua linguagem preferencial. Recomendamos a utilização de um SDK, uma vez que este cuida dos detalhes da autenticação e dos pedidos HTTPS por si, para que possa chamar a API Looker através de chamadas de funções simples.
Encontra detalhes do SDK na página de documentação SDKs da API Looker.
Autenticação
O Looker autentica os pedidos de API através de um token de acesso de portador OAuth 2.0 no cabeçalho de autorização HTTP do pedido. Todos os pontos finais da API Looker requerem uma ligação HTTPS segura para que o token de acesso esteja seguro em trânsito.
Os passos para o conseguir dependem de estar ou não a usar um SDK. Pode encontrar instruções detalhadas na nossa página de documentação Autenticação da API Looker.
Documentação interativa da API
Para a documentação de referência da API, a extensão API Explorer está disponível no Looker Marketplace. Para mais informações, consulte a página de documentação Usar o Explorador de APIs. Se for um administrador do Looker, também pode aceder ao Explorador de APIs clicando no link Usar o Explorador de APIs na página de administração da API do Looker.
Controlo de versões
A estabilidade da API é uma consideração importante ao criar aplicações. Para ajudar a compreender que pontos finais podem ser alterados no futuro e quais devem permanecer estáveis, marcamos determinados pontos finais como estando em versão beta. Para mais detalhes, consulte a página de documentação Controlo de versões da API Looker.