本文档主要对recog 云平台API接口进行说明，方便SDK的接入， 目前API暂时只支持可见光人脸识别，其它识别会在后续版本中支持

提供开放式rest风格的http web调用。每个调用都要首先获取一个云平台API key的许可及对应的secret key 签名调用示例，比如要创建一个组，则如下方式（示例为get方式 ，post方式同样适用）

http调用如下: /Group/create?apiKey=test111&groupName=df&groupDesc=888&apiSign=4B3D74FA5D19CF36B5576C697A157F8D4FD91576

其中apiKey是为你在云平台申请的key(上边示例中对应的密码key 为11111111111111 ),每次调用必填。 apiSign为对每个调用请求参数按字母升序排序后将参数名与参数值拼接在一起加上apiKey申请时获得的私密Key, 再进行SHA1 签名生成并转换成16进制大写字母，再将该参数加入到请求参数中去.服务端java签名生成算法示例代码如下：

说明：paramMap 为存放上传参数映射 （对于http二进制上传时的文件型表单参数目前不计算在内的）

原型： Map paramMap = new HashMap <String, String>();

对于数组类型参数，需要将参数行归并到一个Key下，比如：

http参数有：a=1&a=2&a=3则 需签名时 转换为 a=[1,2,3] （java的话就是Arrays.toString()方法,云平台端服进行参数签名时的预处理java代码如下：

             
/********************获取所有参数列表（注意，http二进制文件上传时文件参数是不会在其中的**************/
          Enumeration pNames = request.getParameterNames();
          while (pNames.hasMoreElements()) {
               String name = (String) pNames.nextElement();
               String[] values = request.getParameterValues(name);
               if (values != null && values.length > 1) { // 数组型
                    paramMap.put(name, Arrays.toString(values)); //数组型的参数将参数内容合
               } else if (values != null) {
                    paramMap.put(name, values[0]);
               }
               // System.out.println(name+"="+paramMap.get(name));
          }
/****************************以上为参数预处理部分*******************/
/**********************签名生成部分************************/
     //参数取参数名再按照字母升序重新排序
          String[] keyArray = paramMap.keySet().toArray(new String[0]);
          Arrays.sort(keyArray);
          // 拼接有序的参数名-值串
          StringBuilder stringBuilder = new StringBuilder("");
          for (String key : keyArray) 
          {
              stringBuilder.append(key).append(paramMap.get(key)); //拼接
          }
          stringBuilder.append(secretKey);//加上私密Key
          String codes = stringBuilder.toString();    
          System.out.println(codes); //
          String sign = DigestUtils.sha1Hex(codes).toUpperCase(); //SHA1签名