API 调用方式

开放平台API 调用为HTTP 方式，API采用REST风格，开发者需要按一定格式自行拼装HTTP请求进行API 调用，具体可参考实例代码。

一，调用参数

调用API ，必须传入系统参数和应用参数。

1）系统参数详细介绍：

2）应用参数，参见API内的参数说明

3）签名sign

调用API 时服务器需要对请求参数进行签名验证。方法如下：

根据参数名称（除签名和图片）将所有请求参数按照字母先后顺序排序:key + value .... key + value

例如：将foo=1,bar=2,baz=3 排序为bar=2,baz=3,foo=1，参数名和参数值链接后，得到拼装字符串bar2baz3foo1 将secretKey 拼接到参数字符串头、尾。

例如：secretKey为secret123，则得到的字符串为secret123bar2baz3foo1secret123将得到的字符串进行md5加密后，再转化成大写.

JAVA实例代码：

//signContent为拼装后的待加密字符串
     String sign= "";
     try {
          MessageDigest md = MessageDigest.getInstance("MD5");
          md.update(signContent.getBytes("UTF-8"));
          byte[] byteData = md.digest();
          StringBuilder sb = new StringBuilder();
          for(int b : byteData){
              b = b&0xFF;
              if(b<16)
                  sb.append('0');
             sb.append(Integer.toHexString(b));
          }
          sign= sb.toString().toUpperCase();
      } catch (Exception e) {
        e.printStackTrace();
      }

二，拼装HTTP请求

所有的参数值转换为UTF-8编码。

 查询类API使用GET请求，修改类API使用POST请求

 订单请求发送到[http://wop.wangjubao.com/rest/trade](http://wop.wangjubao.com/rest/trade)
 会员类请求发送到[http://wop.wangjubao.com/rest/buyer](http://wop.wangjubao.com/rest/buyer)
 分组请求发送到[http://wop.wangjubao.com/rest/buyergroup](http://wop.wangjubao.com/rest/buyergroup)
 标签请求发送到[http://wop.wangjubao.com/rest/buyerlabel](http://wop.wangjubao.com/rest/buyerlabel)
 积分请求发送到[http://wop.wangjubao.com/rest/jifen](http://wop.wangjubao.com/rest/jifen)
 营销请求发送到[http://wop.wangjubao.com/rest/ump](http://wop.wangjubao.com/rest/ump)
 购物车请求发送到[http://wop.wangjubao.com/rest/shopcart](http://wop.wangjubao.com/rest/shopcart)
 收藏夹请求发送到[http://wop.wangjubao.com/rest/favor](http://wop.wangjubao.com/rest/favor)
 评价请求发送到http://wop.wangjubao.com/rest/rate

三，错误码