第四十天：机智云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来保证通信的安全性。