ctiot-api-client v1.0.0

中国电信物联网平台接口客户端

功能

该客户端主要用于连接中国电信物联网 API。

使用方式

接口发生错误

有很多种情况会导致接口发生错误，例如调用接口的用户名密码错误、参数错误、当前卡片状态不支持该操作等。因为运营商接口返回值不可预测，凡是没有得到正确格式的返回值，全部抛出错误，错误的内容就是接口全部返回值。共有以下几种错误场景：

网络错误

表现： 原因：

• 运行主程序的网络环境异常； 处理方式：捕捉到异常之后，直接将异常抛出，由主程序处理

参数错误

原因：

• 用户名、密码、密钥等关键基础信息错误；
• 调用具体方法时提供的参数错误； 表现：
• 接口会返回 -1/-2/-3 等文本格式而不是 xml 格式的信息；
• 接口会返回 html 格式的信息；
• 接口会返回 xml 格式但不是预期的信息，比如部分节点和预期的节点的值或者结构不同； 处理方式：

运营商远程服务器错误

原因：

• 远程服务器故障； 表现：
• 远程服务器无响应；
• 返回值不是正确的格式 处理方式：

日志记录

因为运营商的接口经常出现问题。为了方便对非查询类即操作类接口办理的业务结果进行审计，只要是非查询类接口访问的结果全部记录日志。

• 能够正确转换为 json 格式的响应结果，直接打印转换后的 json 格式；
• 不能正确转换为 json 格式的，例如字符串、html 等格式，直接打印原始格式；

日志的默认保存路径和文件名是在 ./logs/operator-ctcc.log