Looker API 是一种安全的“RESTful”应用编程接口,用于管理 Looker 实例并通过 Looker 数据平台提取数据。借助 Looker API,您可以编写应用或自动化脚本来配置新的 Looker 用户账号、运行查询、安排数据传送等。您几乎可以通过 Looker API 执行在 Looker 应用中可以执行的任何操作。
Looker API 路径和端口
通过 Looker 实例的 API 网址访问其 API。
Looker 管理员可以在管理 > API 页面上的 API 主机网址字段中输入 API 路径,格式如下:
https://<instance_name>.cloud.looker.com
Looker 管理员还可以使用 API 主机网址字段来分配与 Looker 服务器机器名称不同的 API 路径。当 Looker 安装位于负载均衡器后面时,这种情况很常见。在这种情况下,请与 Looker 管理员联系,获取 API 路径。
如果 Looker 管理员未指定 API 主机网址字段,Looker 会使用默认 API 路径。对于托管在 Google Cloud、Microsoft Azure 上的 Looker 实例,以及托管在 Amazon Web Service (AWS) 上且在 2020 年 7 月 7 日或之后创建的实例,默认 Looker API 路径使用端口 443
。对于 2020 年 7 月 7 日之前创建的托管在 AWS 上的 Looker 实例,默认 Looker API 路径使用端口 19999
。默认 API 网址采用以下格式:
https://<instance_name>.cloud.looker.com:<port>
客户端 SDK
您可以在任何能够发出 HTTPS 请求并处理 JSON 响应的编程语言或应用环境中使用 Looker API。您可以使用 curl(或同等工具)、Looker Ruby SDK 手动构建 Looker API HTTPS 请求,也可以为您选择的语言生成客户端 SDK 库。我们建议使用 SDK,因为它可以为您处理身份验证和 HTTPS 请求的详细信息,以便您通过简单的函数调用来调用 Looker API。
您可以在 Looker API SDK 文档页面上找到 SDK 详细信息。
身份验证
Looker 通过使用请求的 HTTP 授权标头中的 OAuth 2.0 不记名访问令牌来对 API 请求进行身份验证。所有 Looker API 端点都需要安全的 HTTPS 连接,以便在传输过程中确保访问令牌的安全。
实现此目的的步骤取决于您是否使用 SDK。如需详细说明,请参阅我们的 Looker API 身份验证文档页面。
交互式 API 文档
如需查看 API 参考文档,请从 Looker Marketplace 获取 API Explorer 扩展程序。如需了解详情,请参阅使用 API Explorer 文档页面。如果您是 Looker 管理员,还可以通过点击 Looker 的 API 管理页面上的使用 API Explorer 链接来访问 API Explorer。
版本控制
构建应用时,API 稳定性是一项重要的考虑因素。为了帮助您了解哪些端点将来可能会发生变化,哪些端点应该保持稳定,我们会将某些端点标记为 Beta 版。如需了解详情,请参阅 Looker API 版本控制文档页面。