前端调用接口简介

---

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

2. 开发示例（java示例）

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

1. 请求报文

   1. 请求报文格式示例

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

   2. 请求报文格式说明

      1. 报文由head和body两部分组成，其中head中元素及格式固定，body中元素及格式根据具体业务会不同。
      2. head元素列表
         

         出现位置	信息项英文名称	信息项名称	描述
         请求、应答	sender	发送方	固定值:04
         请求、应答	receiver	接收方	固定值:00
         请求、应答	appid	应用系统	固定值:A8
         请求、应答	userid	操作员id	登录的操作员的userid
         请求、应答	transcode	报文交易代码	用于区分各业务功能，是最重要的参数
         请求	trantime	发送时间	yyyyMMddhhmmss
         请求、应答	iseqno	报文流水号	示例：201107101503120011，由前端生成
         应答	retcode	应答代码	retcode只有两种值，code=0001表示请求成功，code=9999，表示请求失败，这个时候你们取retmsg（请求失败原因）
         应答	retmsg	应答信息	提示信息（只有retcode=9999的时候取）

      3. body结构
         一般包括head和list两部分（（一般具体业务参数，都放在body的head里。如有特殊情况，会在具体业务中说明），具体内容会根据业务进行详细说明
         

2. 应答报文

   1. 应答报文格式示例 { "head"：{ "appid":"78", "transcode":"010101", "trantime":"20110710150312", "iseqno":"201107101503120011", "retcode":"0001" }, "body":{ "list":{ "acc_info":{ "dwmc": "信宝行汽车销售服务有限公司"， ...中间省略，具体字段参考上表... } } } }
   2. 应答报文说明 retcode:0001表示请求成功，9999，表示请求失败;当请求失败时，可获取retmsg显示失败原因。