第四十天:机智云API介绍
机智云Web Socket API服务是一套API接口,旨在满足基于Html5应用(如微信公众号)的远程设备控制和实时设备状态展示需求。它通过使用Web Socket协议来实现长连接通信,可以将设备数据实时传输到网页并进行展示。与HTTP协议相比,Web Socket协议具有以下区别:[*]HTTP协议是单向通信,客户端主动向服务端发送请求,而Web Socket协议是双向通信,服务端和客户端都可以主动发送数据。
[*]HTTP协议是短连接,每次请求都需要建立新的连接,而Web Socket协议是长连接,保持连接状态,可以持续传输数据。
在使用设备控制API与服务端通讯时,采用UTF-8编码进行数据传输。如果数据点中的枚举值包含非ASCII字符,需使用Unicode编码。请注意,如果设备未成功绑定,是无法调用Web Socket API提供的控制设备指令的。在设备控制API协议中,参数的详细描述如下:
[*]did:目标设备的did(设备ID)。
[*]attr:属性值,需要根据数据点的定义来设置。
[*]raw:自定义内容,需要符合p0协议的定义。
需要特别注意的是,did是通过Open API注册设备后返回的结果,attr的值要和数据点的定义相匹配,raw的值要符合p0协议的定义。可以在Open API文档中获取参数的详细意义。Web Socket API也支持SSL通信,可以通过使用SSL来保证通信的安全性。
页:
[1]