文档中心
机智云 文档中心
English
热搜词
APP
SDK
Android
ios
WIFI
企业应用开发
文档编辑

概述

企业应用是指企业将设备接入机智云后,企业需要获取设备数据用于实现企业特定的业务管理功能,以实现企业对设备、设备消费者的运营管理需要。通常企业应用在开发过程中,不仅需要通过机智云平台获取接入设备的数据,也需要通过企业API去控制设备、进行设备数据的统计分析。让企业集中精力关注企业应用的整体业务。

SNoti服务

SNoti服务是一个实时设备消息传输服务,该服务可以实时将企业的设备数据推送到企业应用系统,企业应用系统基于设备数据实现业务需求。

SNoti服务的能力

  • 基于消息发布/订阅模型
  • 设备数据传输平均时长40-50ms
  • 支持多客户端同时请求
  • 支持SSL传输
  • 设备消息默认缓存3天,并可按企业需求定制
  • 提供设备消息的监控预警

企业API

企业API是从接入机智云平台的企业的运营管理的需求出发,基于企业接入到机智云平台所产生的数据,为企业提供企业视角全局的设备管理、数据分析等功能,让企业更关注业务管理系统本身,减少不必要的开发成本与时间。

案例介绍

充电桩SaaS平台

充电桩SaaS平台是充电桩运营商为电动车主提供了寻找电桩、预约、充电、支付等功能,运营商通过运营管理平台对充电桩、故障、订单、计费规则、订单管理、结算等管理功能。充电桩运营商通过充电桩SaaS平台可以完整闭环的管理日常业务,大大提高运营效率。

充电桩设备接入了机智云,充电桩SaaS平台需要实时获得充电桩的数据,根据这些数据才能计算充电费用,是否有故障等。这些设备数据正是由机智云PaaS平台负责采集,并通过SNoti服务实时推送给充电桩SaaS平台。

充电桩SaaS平台还可以通过企业API开放的接口进行统计分析,如设备的位置服务查询,设备通信数据查询,充电桩故障数查询等功能

分时租赁系统

分时租赁平台的业务其实与充电桩SaaS平台类似,对于分时租赁的运营管理方,如运营汽车租赁、自行车租赁的企业。这些企业需要建设一套分时租赁管理平台,实现订单、结算、支付等必要功能。

汽车、自行车接入到机智云,企业就无需在设备的物联接入进行投入,企业只需通过接入协议接入SNoti服务即可获取设备数据进行业务开发。

开发流程

SNoti服务接入

1、提出申请

  • SNoti服务通常是向企业开发者开放,如果企业需要实时获取接入到机智云PaaS平台的数据进行二次开发,则向机智云提出申请
  • SNoti服务一般会与企业API服务共同使用,所以企业开发者也要同步申请企业API服务

2、理解协议

具体协议请点击 SNoti服务接口协议

3、获取参数

登录开发者中心,获取机智云为企业分配的访问SNoti服务与企业API的账号与秘钥。选择“企业信息”,如下图

@企业API开通申请

选择左侧组织,然后再点击“API配置”,即可获取Eid,Esecret,也可以在此设置IP白名单,若不设置IP白名单,消息代服务将会鉴权失败。
@企业API开通申请

如果是在开发环境,企业开发者需要通过一些工具获取开发环境对应的外网IP,可以通过ip.taobao.com获取,将识别出的IP地址复制到上图IP白名单,一行只能设置一个IP地址,对于生产环境,系统允许设置多个源IP地址访问消息服务。

4、按需实现客户端

企业根据Demo Code,根据自己的需求实现客户端功能开发,可以以Demo Code为原型,实现接收到设备数据后的业务逻辑。如:

  • 解析SNoti服务推送的JSON报文
  • 实时将获取的消息Publish到企业应用所属的队列中,进行异步操作;
  • 也可直接解析后,将数据写入数据库;但需要建立数据的定期清理策略

5、通过虚拟设备模拟真实设备推送数据

企业如果还没有真实设备接入到机智云,可以使用虚拟设备模拟一遍。

  • 启动Demo Code,前提是已经修改为正确的enterpriseId与enterpriseSecret

  • 在该企业组织下创建产品,并定义数据点

  • 在该产品下申请企业API服务

  • 审批通过后即可启动虚拟设备,并模拟数据,点击”推送“

  • Demo Code会实时打印SNoti服务推送的设备状态数据

使用企业API

1、申请企业API服务

企业开发者登陆开发者中心,选择添加服务,如下图
@企业API申请

点击上图红色框中的企业API,进入下一步

@企业API开通申请

2、获取参数

登陆开发者中心,选择“企业信息”,如下图

@企业API开通申请

选择左侧有权限可管理的组织,然后点击“API配置”,即可获取Eid,Esecret,也可以在此设置IP白名单
@企业API开通申请

3、理解协议

企业API申请后,企业就可以通过理解企业API协议进行接口调用

点击 企业API