Looker API 使用入门

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 路径。对于在 2020 年 7 月 7 日当天或之后创建的托管在 Google Cloud、Microsoft Azure 上的 Looker 实例,以及托管在 Amazon Web Service (AWS) 上的 Looker 实例,默认的 Looker API 路径使用端口 443。对于托管在 AWS 上且创建于 2020 年 7 月 7 日之前的 Looker 实例,默认的 Looker API 路径使用端口 19999。默认 API 网址采用以下格式:

https://<instance_name>.cloud.looker.com:<port>

客户端 SDK

您可以将 Looker API 与任何可以发出 HTTPS 请求并处理 JSON 响应的编程语言或应用环境搭配使用。您可以使用 curl(或等效工具)、Looker Ruby SDK 或为您选择的语言生成客户端 SDK 库,手动构建 Looker API HTTPS 请求。我们建议使用 SDK,因为它会为您处理身份验证和 HTTPS 请求的详细信息,以便您可以使用简单的函数调用来调用 Looker API。

您可以在我们的 Looker API SDK 文档页面中找到 SDK 的详细信息。

身份验证

Looker 通过在 API 请求的 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 版本控制文档页面。