跳至主要内容

机器人API接入

机器人API接入​

在监控平台中,如果需要接入清扫机器人相关数据,首先您需要进行“织光智能”API账号的添加。 在获取API账号下的机器人站点列表后,选择站点进行监控电站的创建(详见创建电站),或者将机器人站点与监控中已创建的电站进行关联。 上述操作完成后,机器人相关数据将在监控平台中进行展示、统计和分析。

API账号管理​

点击顶部导航栏最右侧的头像图标,进入【用户中心】,切换至【API数据接入】tab。


该页面包括清扫机器人API账号添加功能、账号信息编辑功能、账号删除功能、API密钥列表。


API密钥列表​

清扫机器人API密钥列表中展示当前用户添加的账号信息。


账号添加​

1.展开“API概述”,点击【添加账户】按钮,进入账号添加页面;


2.选择“清扫机器人”设备类型;


3.输入账户信息 参数 说明 选择厂商 必选,目前仅支持:织光智能 选择地区 必选,目前仅支持:中国大陆 app_key 必填,支持数字、字符、字母 app_secret 必填,支持数字、字符、字母

4.单击【保存】按钮,即可新增成功。 5.注意:一个API账户同一时间不可以添加多次。

账号信息编辑​

1.选择需要编辑的API账户,点击【编辑】图标,进入编辑页面;


2.编辑页面初始回显当前数据,编辑信息:


参数 说明 选择厂商 必选,目前仅支持:织光智能 选择地区 必选,目前仅支持:中国大陆 app_key 必填,支持数字、字符、字母 app_secret 必填,支持数字、字符、字母 默认加密显示,点击“眼睛”图标,切换为明文显示

3.点击【保存】按钮,即可完成编辑。 4.注意:编辑后的API账户信息,不支持修改为平台中已经存在的API账号信息。

API账号删除​

1.选择需要删除的API账户,点击【删除】图标,确认删除后即可删除改用下的API账号显示;



2.注意:API账户在监控平台被用户删除后,API账号及其数据仍然会在后台留存,如需删除后台留存数据,请联系平台运营。

API创建电站​

点击顶部导航栏右上角的【创建电站】;


目前提供三种种创建电站的渠道方式:手动创建电站、通过逆变器厂商API创建电站、通过清扫机器人厂商API创建电站。


如果您的电站,在清扫机器人厂商中,已经维护过设备及站点相关信息,您可以选择通过API方式同步场站信息。

1.选择“通过清扫机器人厂商API创建电站”,点击【开始创建】按钮,进入创建电站流程页面。


本平台目前支持:织光智能清扫机器人厂商的API数据接入,如您需要接入其他厂商的清扫机器人数据,请联系客服或自行上报。 客服邮箱:info@z-erengy.tech

2.选择电站逆变器的品牌厂商,点击【下一步】;


3.如果尚未维护过厂商API账号,可点击【添加API账号】按钮,添加API账号。具体可参考上文:机器人API接入-API账号管理


如果已添加过API账号,选择API账号后点击【下一步】。


4.选择一个或者多个站点,点击【创建电站】按钮,页面中显示创建成功,表示您已经成功创建了属于您的光伏电站。

需要注意:通过API批量创建电站,因为机器人厂商对数据字段的开放程度不一样,需要创建后前往电站信息对电站数据进行校对。


取消站点接入​

基于站点创建的光伏电站,可点击【取消接入】按钮。操作完成后,该光伏电站将不在显示:站点下的清扫机器人设备及相关数据。

注意: 已经创建的光伏电站在监控平台依然存在; 取消接入操作完成后,可以重新基于站点进行光伏电站创建、匹配监控电站操作。

匹配监控电站​

在进行API创建电站流程中,如果存在部分站点,已经在监控系统平台通过其他方式完成了光伏电站创建,可以通过【匹配监控电站】功能,将站点和已经创建的光伏电站进行关联。


点击站点数据右侧的【匹配监控电站】按钮,搜索选择监控系统中光伏电站,确认操作后完成匹配。匹配后,站点信息及其机器人相关历史数据,将自动在该光伏电站下展示、统计。

注意: 监控系统平台中的光伏电站,在同一时刻只能和一个站点关联; 一个站点,在同一时刻,只能和一个光伏电站关联。


解绑监控电站​

站点和已经创建的光伏电站关联后,点击【解除站点匹配】按钮,确认操作完成后,该光伏电站下将取消显示:站点清扫机器人设备及相关全部数据。