1、功能接口调试

为方便云信使用户快速测试与调试本系统功能,云信使业务管理系统提供了一套易于使用的“接口调试工具”。用户登录云信使业务管理,在左侧菜单展开“接口调试工具”,即可看到各项业务的调试工具。
每项业务的调试工具都有完全相同的结构布局,下面以“短信应用”为例,介绍接口调试工具的使用。调试工具如下图所示:



对照上图,各功能说明如下:
1、接口地址:每项业务都有一个处理业务请求的URL,该URL在各个业务的开发文档中亦分别有说明;
2、接口功能:罗列了该业务可用的功能,用户选择一项功能,该功能对应的XML数据包即以精简模式(只显示必要参数)的形式显示在下方文本框;
3、XML数据包:所选功能对应的XML数据包的内容,调试工具会自动取得当前登陆账号和加密过的密码,然后合成数据包;
4、完整XML数据包模式:以完整模式显示该功能的XML数据包,完整模式的含义:包含必要参数和可选参数(并非每项功能都有可选参数,如果所选的功能没有可选参数,则勾选此项后上述文本框无变化);
5、调用返回:用户构造好测试数据包后点“试一试”按钮,调试工具立刻将XML数据包提交到接口地址并同步取得提交结果,结果显示在“调用返回”块中,多次调用会叠加生成多个返回块,以方便用户调试;

2、观察接口调试返回值

为方便用户比对、调试、查找问题,所有通过接口调试工具发送的数据包均会被临时保存在“接口调试日志”中,该日志存储了当天用户调试的数据,包括发送到接口的XML数据包和接口返回的数据包(收发匹配),并支持搜索。注意:该列表只保存当天的调试数据,隔日零点将被自动清空。如下图所示:



3、回调消息调试

用户在测试阶段进行调试,业务的回调数据亦可回调到调试工具,当用户将业务的回调地址设置为“https://api.yunxinshi.com:8081/ReceiveEventDemo.do”时(关于回调机制,请参照“接口调用与回调消息介绍”),业务的回调数据将被保存到调试工具中的“回调数据列表”。注意:该列表只保存当天的回调数据,隔日零点将被自动清空。如下图所示: