业务侧接口-RESTfulAPI_20151216..docx

OneNet接入方案与RESTfulAPI接口欢迎访问设备云门户网站//注册用户，获取必威体育精装版文档。版本号修订日期修订内容说明V1.12014.10.30EDP增加存储数据报文；REST API 增加历史数据查询接口，用于上报数据点，或者上报的同时转发数据点。V1.1.12014/11/3EDP增加消息类型9，以支持对存储数据的确认。V1.1.22015/01/101、修改3.5.3 AB接口，增加获取每个数据流当前值。2、数据点添加时若无数据流将自动添加数据流。V1.2.22015/01/15修改3.5.1 ，新增数据流返回uuid，唯一标识该数据流；修改3.5.1，增加三种复合数据流的添加；修改触发器相关操作接口。一个触发器可同时监控不同设备的多个数据流。修改触发器一些条件的设定方式。V1.2.32015/06/18去掉复合数据流定义设备批量查看增加device_id 参数触发器增加title字段新增触发器批量获取接口修改key查看输出内容格式V1.3.02015/06/241、命令操作，增加响应内容查询V1.3.12015/07/281、修改4.6.3，新增数据点抽样和统计目录OneNet接入方案与RESTfulAPI接口11概述32基于OneNet的应用系统的典型场景33API资源模型34REST API54.1设计原则54.2HTTP 原始报文格式64.3设备（device）64.3.1新增64.3.2更新74.3.3查看84.3.4删除114.4数据流（datastream）124.4.1新增124.4.2更新124.4.3查看134.4.4删除144.5数据点（datapoint）144.5.1新增144.5.2更新164.5.3查看164.5.4删除194.6触发器（trigger）194.6.1新增194.6.2更新204.6.3查看214.6.4删除224.7API 权限(apikey)234.7.1新增234.7.2更新234.7.3查看244.7.4删除254.8二进制数据（bindata）254.8.1新增254.8.2查看264.8.3删除264.9命令执行（cmd）264.9.1发送命令264.9.2查看状态274.9.3获取响应274.10其他284.10.1触发数据内容284.10.2历史数据查询29概述OneNet是中移物联网有限公司基于物联网技术和产业特点打造的开放平台和生态环境，适配各种网络环境和协议类型，支持各类传感器和智能硬件的快速接入和大数据服务，提供丰富的API和应用模板以支持各类行业应用和智能硬件的开发，能够有效降低物联网应用开发和部署成本，满足物联网领域设备连接、协议适配、数据存储、数据安全、大数据分析等平台级服务需求。中国移动物联网开放平台始终秉承开放合作的态度，为智能硬件创客和创业企业提供硬件社区服务，为中小企业客户物联网应用需求提供数据展现、数据分析和应用生成服务，为重点行业领域/大客户提供行业PaaS服务和定制化开发服务。是OneNet对外公开的门户，可以通过该门户了解到OneNet的必威体育精装版进展。本文档主要描述了OneNet基于HTTP方式向外提供API接口以及这些接口的调用方式、参数说明等等。这些接口按照RESTful的方式向外提供服务。基于OneNet的应用系统的典型场景设备层：利用平台提供的EDPSDK，实现EDP协议，用于上报业务数据点到OnetNet。若需要实时接收业务层下发的控制命令，需要保持EDP长连接。业务应用层：若要自定义实现业务平台，可通过HTTP 协议的RESTful API操作OnetNet提供的资源（设备、数据点、命令控制等资源的增删查改）。适用场景：在充分分析业务数据模型的基础上，认为OneNet提供的设备-数据流-数据点模型适合业务数据存储。优先推荐新业务使用该模式。API资源模型OneNet HTTPAPI按照RESTful的方式向外提供服务，其资源模型中包含的资源种类有：用户、设备（device）、数据流（datastream）、数据点（datapoint）、触发器（trigger）、API key、命令等。用户是指通过注册的用户。每个用户可以建立多个项目，每个项目可以添加多个设备。一个设备只能属于一个项目。一个设备可以产生多个数据流，一个数据流可以理解为一类数据。比如温度是一个数据流、经纬度是一个数据流等等。数据流中的一个具体的数据称为数据点。数据点采用Key-Value方式的存储的。其中Key的组成包括设备id、数据流id、时间等信息，value部分可以为任何数据对象，如整数、字符串或者JSON数据类型。API Key用于对设备云进行操作的权限控制，在访问OneNet Rest API时，http请求消息的头域必须携带api-key字段