Looker API 是一种安全的“RESTful”应用编程接口,用于管理 Looker 实例并通过 Looker 数据平台提取数据。借助 Looker API,您可以编写应用或自动化脚本来预配新的 Looker 用户账号、运行查询、安排数据传送等。您可以在 Looker 应用中执行的几乎所有操作都可以通过 Looker API 执行。
Looker API 路径和端口
通过 Looker 实例的 API 网址访问该实例的 API。
您的 Looker 管理员可以通过在 API 主机网址 字段中输入 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 实例,以及在 2020 年 7 月 7 日或之后创建的托管在 Amazon Web Service (AWS) 上的实例,默认 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 版本控制 文档页面。