基于接入机智云设备数据开展企业某个垂直领域业务需求

企业应用是企业将设备接入云平台后，企业需要获取设备数据用于实现企业特定的业务管理功能，以实现企业对设备、设备消费者的运营管理需要。企业应用在开发过程中，通过机智云物联网平台的 SNoti 服务功能即可获取接入设备的数据，同时基于企业 API 实现控制设备、进行设备数据的统计分析，让企业集中精力关注企业应用的整体业务。

01 SNoti 服务功能

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

注意：使用 SNoti 服务之前，要先开通 SNoti 服务和添加白名单。

SNoti 服务的能力包括：

◆ 基于消息发布/订阅模型；

◆ 设备数据传输平均时长40-50ms；

◆ 支持多客户端同时请求；

◆ 支持 SSL 传输；

◆ 设备消息默认缓存3天，并可按企业需求定制；

◆ 提供设备消息的监控预警。

02 企业 OPEN API

企业 OPEN API 是机智云为接入机智云平台的企业开发者提供的开放 API 服务，使用企业 API 的企业将设备接入到机智云平台后，通常还有进一步基于接入机智云设备数据开展企业某个垂直领域的业务需求。

企业 API 为企业提供企业视角全局的设备管理、数据分析等功能，让企业更关注业务管理系统本身，减少不必要的开发成本。

注意：注册开发者中心的企业用户是默认开通企业 API 。

03案例介绍说明

充电桩 SaaS 平台

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

充电桩设备接入了机智云，充电桩 SaaS 平台需要实时获得充电桩的数据，根据这些数据才能计算充电费用，是否有故障等。

这些设备数据正是由机智云 PaaS 平台负责采集，并通过 SNoti 服务实时推送给充电桩 SaaS 平台。充电桩 SaaS 平台还可以通过企业 API 开放的接口进行统计分析，如设备的位置服务查询，设备通信数据查询，充电桩故障数查询等功能。

分时租赁系统

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

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

04 开发流程介绍

SNoti 服务接入

1、提出申请

步骤①：企业开发者登陆新版开发者中心

https://developer.gizwits.com/#/login

点击右上角【账号】-【企业信息】-【服务中心】，如下图。

步骤②：选择左侧组织，再点击【数据推送服务】，点击【立即开通】，申请开通后等待审核。

步骤③：待审核通过后，点击【返回旧版】，需返回旧版开发者中心使用此功能。（由于新版功能还在开发完善中，部分功能仍会在旧版使用中）。

2、获取参数

选择产品，然后再点击【SNoti 服务】，点击“新建授权”创建，该 auth_id 拥有获取该产品下所有设备消息和控制设备的权限；

3、理解协议

具体协议见：

http://docs.gizwits.com/zh-cn/Cloud/NotificationAPI.html

4、按需实现客户端

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

◆ 解析 SNoti 服务推送的 JSON 报文

◆ 实时将获取的消息 Publish 到企业应用所属的队列中，进行异步操作；

◆ 也可以直接解析后，将数据写入数据库，但需要建立数据的定期清理策略。

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

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

◆ 启动 Demo Code，前提是已修改为正确的 product_key，auth_id与auth_secret；

◆ 在该产品下并定义了数据点；

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

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

使用企业 API1、默认开通企业API服务企业开发者登录新版开发者中心，注册开发者中心的企业用户默认开通企业API。

https://developer.gizwits.com/#/login

可查看已开通的服务，如下图。

2、获取参数

登陆新版开发者中心，点击右上角的【账号】，选择【企业信息】，选择左侧有权限可管理的组织，然后点击【API配置】，即可获取Eid，Esecret，也可以在此设置IP白名单，如下图所示。

3、理解协议

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

审核编辑：彭静