ComwayWeb云通信开发参考手册.PDF

北京天同诚业科技有限公司 电话：86-10 地址：北京市海淀区苏州街75 号7 号楼102 室 邮编：100080 Comway Web 云通信开发参考手册 本章节介绍Comway Web 云通信开发提供的所有应用程序接口、方法以及对应的参数。 Comway Web 云通信开发API 返回内容分为二种类型：第一种是直接返回一个字符串，用来表示调用的 结果；第二种是返回XML 格式的查询结果。 具体而言，Comway Web 云通信开发API 支持您的网站/业务系统用以下方式调用Comway Web 云通信开 发API： 1. 发送数据到Comway Web 云通信平台，并得到dtu 下位机的响应结果。 2. 发送控制指令到Comway Web 云通信平台，并得到响应结果。 3. 下位机数据主动上报。DTU 下位机上报数据以及DTU 状态变化信息，通过用户提交的 callback 参 数指定的链接上报，便于用户取得DTU 上报数据，与自有系统集成。 API 基本工作流程 若需要使用该API，用户必须先在Comway 服务器进行注册后，将注册信息提交云通信开发后台管理员 进行API 开户，对Comway Web 云通信开发API 的每个调用流程都分为以下2 个步骤： 调用请求的鉴权 将Comway 服务器用户ID 赋值给userid，密码通过md5 加密后的密文赋值给pass 这一必填变量，并用HTTP GET/POST 方法发送给Comway Web 云通信开发API。Comway Web 云通信开发API 根据收到的 pass 以及用户 ID 验证请求的合法性和有效性。 请求的处理 对于通过成功鉴权的请求，Comway Web 云通信开发API 将根据调用的方法进行对应的处理。 对于未通过成功鉴权的请求，Comway Web 云通信开发API 将拒绝并返回异常信息。 参数说明 所有Comway Web 云通信开发API 请求都必须包含以下参数： pass：用户密码，字符型 您在Comway 客户端注册的帐号对应的密码通过MD5 加密后的32 位字符串。 userid：用户ID，字符型 您在Comway 客户端注册的帐号对应的用户ID。 其他参数说明： dtuid：Comway dtu 设备编码，数据将发送到对应此设备编码的dtu。 timeout: 请求的超时时间，默认为30 秒。 发送数据的timeout 若为0，则只将数据下传到下位机，不等待结果，直接返回。 控制指令的timeout 不能为0。 1 / 10 北京天同诚业科技有限公司 电话：86-10 地址：北京市海淀区苏州街75 号7 号楼102 室 邮编：100080 返回的状态码 （返回信息的前2 个字节表示状态码） 00：正常， ‘00’ + ','号分隔 + 相应的dtu 下位机响应结果。 01：关键参数缺失或者参数赋值错误。 02：用户名或者密码不正确，无法登录Comway Web 云平台。 03：下位机请求超时。 04：服务器内部错误，请联系Comway Web 云平台技术支持。 05：指令调用失败，请确认该DTU 是否在线。 06：用户未在Comway Web 云通信注册，请先联系管理员注册使用该服务。 07：该dtu 未在指定账户下，请通过公司无线串口客户端软件在账户下添加该dtu。 08：指定dtu 目前是离线状态，请确认该DTU 是否已经上线，也可以通过无线串口软件查看dtu 状态。 API 数据主动上报流程 若用户注册是提交了callback 参数，且为一个正常可以访问的链接，那么该用户下dtu 的状态信息以 及下位机上报的数据会通过这