概述

企业应用是指企业将设备接入机智云后，企业需要获取设备数据用于实现企业特定的业务管理功能，以实现企业对设备、设备消费者的运营管理需要。通常企业应用在开发过程中，不仅需要通过机智云平台获取接入设备的数据，也需要通过企业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配置”，即可获取Eid,Esecret，也可以在此设置IP白名单，若不设置IP白名单，消息代服务将会鉴权失败。

如果是在开发环境，企业开发者需要通过一些工具获取开发环境对应的外网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，进入下一步

2、获取参数

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

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

3、理解协议

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

点击 企业API