(一)API管理

“API管理” 应用是对 API 使用授权的管理。确切的说,就是针对上述的 B 类、C 类的 MixIOT API 使用授权。

我们以一个具体的应用为例,来说明这个 “API管理” 的使用。回顾一下 “调度控制” 中的案例。这个调度项目的调度程序:

看一下调度程序的前面部分:

完整的调度程序很长,详细的解释可以参考 “调度控制” 的章节。这个程序里面需要获取 MixIOT 系统的相关数据,比如调度对象的数据,还要使用反向控制,这些都需要通过 API 进行。

若要使用这些API,就需要使用一个 API授权,这个授权就是 “令牌(Token)”,这个 令牌(Token)需要写在调度程序里面。那么,这个令牌(Token)的获得,就需要使用“API管理”应用。

(二)创建API授权令牌

进入 “API管理” 应用,按下面这个顺序创建一个 API 授权:

命名

给这个授权取一个名字和别名,比如佳华电站调度API授权(API-JHS):

白名单

配置白名单IP地址,是非常重要的一个安全控制节点:

IP 白名单的意思是,这个 API授权只能在那一个 IP地址发起。如果是 MixIOT 应用中的 Lua程序,这里 IP白名单要写成 “0. 0. 0. 0”,意思是这个授权是给MixIOT 自身应用使用的。

如果是第三方自己定制开发的应用,或者是为第三方平台或系统对接而需要使用的API,这个地方就需要填写实际对应的IP地址。

一个 API 授权也可以同时给多个IP地址使用, 比如,如果 MixIOT 需要同时对接 CRM、ERP 和 MES,这个三个对接的 API 也可以使用同一个授权。我们可以通过 “+” 增加 IP白名单。

生成秘钥

点击 “生成密钥”后,就会自动产生一个秘钥字符串。

可以复制这个秘钥,放到我们的 Lua 程序里面:

保存

保存这个 API授权,这个授权就算完成了。

也可以为其他第三方系统对接创建 API授权。

文档更新时间: 2024-07-02 16:42   作者:Mixiot