API认证

更新时间:2022-09-22

如果您的 api 是需要进行认证的,如 AK/SK 鉴权,摘要签名认证等,那么可以在「空间广场页-数据管理-API 认证」页面中配置 API 认证。共支持包括 sugar openapi(sugar 中支持的 openapi)、百度云 API 网关、bos、阿里云 API 网关、如流、钉钉、企业微信、飞书和自定义 API 换 token 在内的 9 种认证方式。

图片

配置 API 认证需要打开「API 认证权限」,可以在「系统设置」->「用户/角色管理」->「权限配置」中进行设置。

图片

设置流程

  1. 新增 API 认证。

图片

  1. 在新增 API 的弹窗中填写名称、api 认证类型,说明和认证需要的 AK、SK。这里以百度云 API 网关为例。

图片

  1. 如果类型选择了「自定义 API 换 token」,以配置出如流的 token 认证为例,调用如流的内部应用业务 api 时,需要在 query 参数中传递access_token 字段,所以 调用业务api时使用token字段的位置选择 query 参数,通过token调用业务api的token字段名access_token通过token调用业务api的token字段值不填即可。 token计算api填写如流中获取 access_token 的 api,一般需要传递 ak/sk 参数,按对应文档要求填写 ak/sk 的字段名和字段值,即下图所示的红框选择的部分。

图片

  • 通过token调用业务api的token字段值:支持使用${TOKEN}值指代通过调用 token 计算 api 得到的 token 值,这样可以自由指定所传 token 的格式,如Bearer ${TOKEN}

调用方式

在大屏和报表的图表使用 api 拉取方式获取数据时,可以开启API认证,在选择API认证的下拉框中选择我们刚刚创建的 API 认证既可。这里以百度云 API 网关为例。

图片

如果 api 返回结果跟图表的数据格式要求不匹配,可以开启 API 高级配置,使用 api 转换器进行转换,详见API 高级配置

本页内容