前端调用接口

---

1. 调用服务端接口需通过富深开发的jar包访问接口
   

2. 开发示例（java示例）

   FrameInvokeServiceClient client = new FrameInvokeServiceClient();  
   
   //此处填写公积金中心的服务地址  
   client.setUrl("http://xxxxxxxxxx/esb/service/invokeService);  
   client.setEncode("GBK");  
   
   //invoke方法完成 编码压缩、发送、获得返回报文、解压和签名对比  
   //retxml是获得的返回明文  
   String retxml = client.invoke("发送json报文明文");  
   
   System.out.println(retxml);```
   1. 报文格式示例  

   { "head"：{ "appid":"78", "transcode":"010101", "trantime":"20110710150312", "iseqno":"201107101503120011" }, "body":{ "head":{ "type": "cas", "logname":"320382199504285013", "xingming":"张三" }, "list":{} } }

   1. 报文格式说明  
   1. 报文由head和body两部分组成，其中head中元素及格式固定，body中元素及格式根据具体业务会不同。
   1. head元素列表  
       <table width='100%'>
       <tr align='left'><th width='20%'>出现位置</th><th width='20%'>信息项英文名称</th><th width='10%'>信息项名称</th><th width='50%'>描述</th></tr>
       <tr align='left'><td>请求、应答</td><td>sender</td><td>发送方</td><td>固定值</td></tr>
       <tr align='left'><td>请求、应答</td><td>receiver</td><td>接收方</td><td>固定值</td></tr>
       <tr align='left'><td>请求、应答</td><td>appid</td><td>应用系统</td><td>固定值</td></tr>
       <tr align='left'><td>请求、应答</td><td>transcode</td><td>报文交易代码</td><td>用于区分各业务功能，是最重要的参数</td></tr>
       <tr align='left'><td>请求</td><td>trantime</td><td>发送时间</td><td>yyyyMMddhhmmss</td></tr>
       <tr align='left'><td>请求、应答</td><td>iseqno</td><td>报文流水号</td><td>示例：201107101503120011，由前端生成</td></tr>
       <tr align='left'><td>应答</td><td>retcode</td><td>应答代码</td><td>retcode只有两种值，code=0001表示请求成功，code=9999，表示请求失败，这个时候你们取retmsg（请求失败原因）</td></tr>
       <tr align='left'><td>应答</td><td>retmsg</td><td>应答信息</td><td>提示信息（只有retcode=9999的时候取）</td></tr>
       </table>
   1. body结构  
     一般包括head和list两部分，具体内容会根据业务进行详细说明