物联网云平台对外数据接口.pdfVIP

浙江托普云农科技股份有限公司 致力于农业信息化的发展 物联网云平台对外数据接口 设计说明书 文件状态 文件标示 研发部 【 】 初稿 当前版本 V1.2 【√】 修改 作者 谢朝明 【 】 发布 日期 2015-07-22 研发部内部文档 1 浙江托普云农科技股份有限公司 致力于农业信息化的发展 修订历史记录 日期 版本 说明 作者 2015-07-22 V1.0 设计初稿 谢朝明 2015-07-23 V1.0 修改稿 宁应财 2015-07-23 V1.1 修正修改，增加设备控制的定时控制参数，增加通过 谢朝明 终端获取所有传感器和控制设备协议，获取最后一组 数据协议，修改部分参数名称 2015-10-08 V1.2 增加地块及地块相关数据查询功能 陈旭 研发部内部文档 2 浙江托普云农科技股份有限公司 致力于农业信息化的发展 1 简介 物联网子系统对外服务接口是物联网系统平台对外部终端设备或第三方应用调用本系 统的功能服务接口。 2 接口使用注意事项 1、 接口标准符合 Rest 风格 2、 Get 方式表示获取,Post 方式表示添加，Put 方式表示修改，Delete 方式表示删除。当有 不支持 Put 或 Delete 方式的客户端时，可使用 Post 代替，在 URL 后面增加参数_method 服务端可自动转为 Put 或 Delete 方式。 3、 使用 Get 方式时需要注意对参数 URL Encode 4 、 使用格式 http://{url}/api/{ 版本}/{资源}/{动作} 或者 http://{url}/api/{ 版本}/{资源}/{id} id为整数，表示对某一个资源的一个编号所对应的记录的操作。 5、 需要登录的操作在 URL 后增加 ut 参数来表示用户令牌的字符串。 6、 使用统一的格式返回 {code:10100a,msg:错误信息,result:{JsonObject}} 7、 code 为0时表示执行成功，其他六位编码为状态码，使用 16 进制字符串，如 10057e 等，错误编码有英文字母存在的则全为小写。msg 为状态描述，当借口需要数据返回时 Result 为 JsonObject 或 JsonArray ，当操作无数据返回时则该参数在返回对象中不存在。 3 接口说明 注意所有的数据返回的格式是指 {code:10100a,msg: 错误信息,result:{JsonObject}} 中的 JsonObject 的数据内容。 研发部内部文档