8.2 API测试工具

8.2.1 API调用超时错误

对于系统提供的HTTP API调用入口,系统默认设置30秒为最大响应时间,在API调用30秒超时后,系统会自动返回类似以下截图的“设备无响应”错误。用户需要查看并修改代码以避免超时的产生。

API调用超时错误

用户可指定CDIF框架的requestTimeout启动选项来指定API调用的最大响应超时时间。

8.2.2 API调用数据校验错误

CDIF框架会对API调用输入和返回的JSON数据做基于JSON schema的严格数据校验功能。当输入或返回的数据不满足应用API规范中要求的JSON schema定义时,系统会提示类似以下错误:

API调用数据校验错误

此时,用户需要修改应用的代码,以满足应用API规范中相关API数据的JSON schema定义要求。或改变API规范中相应的JSON schema定义以通过数据校验。

8.2.3 测试工具表单数据无法自动更新

当初次进入测试工具页面时,系统会自动将中间栏的输入表单与右侧Request框中的JSON请求数据绑定,用户在中间栏中输入的数据将会实时自动反映在右侧的JSON请求数据中,与输入表单中输入的内容一一对应,类似于以下的截图:

测试工具表单数据无法自动更新

为了方便对输入数据做定制化改变,用户可以将鼠标定格到右侧Request框中改变已有的请求数据,或者添加新的字段并提交API测试请求。但在此操作后,中间表单输入栏将与Request框脱离绑定,用户在中间表单栏输入的数据将无法更新到Request框中。此时需要退出并重新进入测试工具页面方可恢复绑定。