有赞 调用 api 接口（有赞开放平台）

ps：先注册有赞账号

有赞

https://www.youzan.com/

有赞开放平台

http://open.youzan.com/

有赞开发者后台

http://open.youzan.com/developer/app/index

接入说明：

http://open.youzan.com/doc

API文档：

http://open.youzan.com/api

*************************************************************

平台介绍

第三方应用接入说明

更新通知

订阅更新

授权方式

免签名通讯协议

签名通讯协议

Oauth2.0授权说明

基础支持

全局错误返回码说明

微信openid

网页授权获取信息

规则与协议

接口需求

*********************************************************

授权方式选择第二种，签名通讯协议。

第一种需要申请应用，第二种则不需要。

第二种针对个人开发者。

下载SDK JAVA 版

三个文件：

KdtApiProtocol.java

package cn.zno.youzan;


import java.io.UnsupportedEncodingException;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;

public class KdtApiProtocol {
    public static final String APP_ID_KEY = "app_id";
    public static final String METHOD_KEY = "method";
    public static final String TIMESTAMP_KEY = "timestamp";
    public static final String FORMAT_KEY = "format";
    public static final String VERSION_KEY = "v";
    public static final String SIGN_KEY = "sign";
    public static final String SIGN_METHOD_KEY = "sign_method";

    public static final int ALLOWED_DEVIATE_SECONDS = 600;

    public static final int ERR_SYSTEM = -1;
    public static final int ERR_INVALID_APP_ID = 40001;
    public static final int ERR_INVALID_APP = 40002;
    public static final int ERR_INVALID_TIMESTAMP = 40003;
    public static final int ERR_EMPTY_SIGNATURE = 40004;
    public static final int ERR_INVALID_SIGNATURE = 40005;
    public static final int ERR_INVALID_METHOD_NAME = 40006;
    public static final int ERR_INVALID_METHOD = 40007;
    public static final int ERR_INVALID_TEAM = 40008;
    public static final int ERR_PARAMETER = 41000;
    public static final int ERR_LOGIC = 50000;

    public static String sign(String appSecret, HashMap<String,String> parames){
        Object[] keyArray = parames.keySet().toArray();
        List<String> keyList = new ArrayList<String>();
        for(int i = 0; i < keyArray.length; i++){
            keyList.add((String)keyArray[i]);
        }
        Collections.sort(keyList);
        String signContent = appSecret;

        for (String key : keyList) {
            signContent += (key + parames.get(key));
        }
        signContent += appSecret;
        return hash(signContent);
    }
    
    private static String hash(String signContent){
        String hashResult = "";
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            try {
                md.update(signContent.getBytes("UTF-8"));
            } catch (UnsupportedEncodingException e) {
                e.printStackTrace();
            }
            byte byteData[] = md.digest();
            StringBuffer sb = new StringBuffer();
            for(int i = 0; i < byteData.length; i++){
                sb.append(Integer.toString((byteData[i] & 0xff) + 0x100, 16).substring(1));
            }
            hashResult = sb.toString().toLowerCase();
        } catch (NoSuchAlgorithmException e) {
        }
        
        return hashResult;
    }
}

KdtApiClient.java

package cn.zno.youzan;


import java.io.File;
import java.net.URLEncoder;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.HashMap;
import java.util.List;

import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.mime.HttpMultipartMode;
import org.apache.http.entity.mime.MultipartEntity;
import org.apache.http.entity.mime.content.ContentBody;
import org.apache.http.entity.mime.content.FileBody;
import org.apache.http.impl.client.DefaultHttpClient;

public class KdtApiClient {
    private static final String Version = "1.0";

    private static final String apiEntry = "https://open.koudaitong.com/api/entry?";

    private static final String format = "json";

    private static final String signMethod = "md5";
    
    private static final String DefaultUserAgent = "KdtApiSdk Client v0.1";

    private String appId;
    private String appSecret;

    public KdtApiClient(String appId, String appSecret) throws Exception{
        if ("".equals(appId) || "".equals(appSecret)){
            throw new Exception("appId 和 appSecret 不能为空");
        }
        
        this.appId = appId;
        this.appSecret = appSecret;
    }
    
    public HttpResponse get(String method, HashMap<String,String> parames) throws Exception{
        String url = apiEntry + getParamStr(method, parames);
        
        HttpClient client = new DefaultHttpClient();
        HttpGet request = new HttpGet(url);
        request.addHeader("User-Agent", DefaultUserAgent);
 
        HttpResponse response = client.execute(request);
        return response;
    }
    
    public HttpResponse post(String method, HashMap<String, String> parames, List<String> filePaths, String fileKey) throws Exception{
        String url = apiEntry + getParamStr(method, parames);
        
        HttpClient client = new DefaultHttpClient();
        HttpPost httppost = new HttpPost(url);
        httppost.addHeader("User-Agent", DefaultUserAgent);
        
        if(null != filePaths && filePaths.size() > 0 && null != fileKey && !"".equals(fileKey)){
            MultipartEntity mpEntity = new MultipartEntity(HttpMultipartMode.BROWSER_COMPATIBLE);
            for(int i = 0; i < filePaths.size(); i++){
                File file = new File(filePaths.get(i));
                ContentBody cbFile = new FileBody(file);
                mpEntity.addPart(fileKey, cbFile);
            }
            
            httppost.setEntity(mpEntity);
        }
        
        System.out.println("executing request " + httppost.getRequestLine());
        HttpResponse response = client.execute(httppost);
        
        return response;
    }
    
    public String getParamStr(String method, HashMap<String, String> parames){
        String str = "";
        try {
            str = URLEncoder.encode(buildParamStr(buildCompleteParams(method, parames)), "UTF-8")
                    .replace("%3A", ":")
                    .replace("%2F", "/")
                    .replace("%26", "&")
                    .replace("%3D", "=")
                    .replace("%3F", "?");
        } catch (Exception e) {
            e.printStackTrace();
        }

        return str;
    }
    
    private String buildParamStr(HashMap<String, String> param){
        String paramStr = "";
        Object[] keyArray = param.keySet().toArray();
        for(int i = 0; i < keyArray.length; i++){
            String key = (String)keyArray[i];

            if(0 == i){
                paramStr += (key + "=" + param.get(key));
            }
            else{
                paramStr += ("&" + key + "=" + param.get(key));
            }
        }

        return paramStr;
    }


    private HashMap<String, String> buildCompleteParams(String method, HashMap<String, String> parames) throws Exception{
        HashMap<String, String> commonParams = getCommonParams(method);
        for (String key : parames.keySet()) {
            if(commonParams.containsKey(key)){
                throw new Exception("参数名冲突");
            }
            
            commonParams.put(key, parames.get(key));
        }
        
        commonParams.put(KdtApiProtocol.SIGN_KEY, KdtApiProtocol.sign(appSecret, commonParams));
        return commonParams;
    }

    private HashMap<String, String> getCommonParams(String method){
       HashMap<String, String> parames = new HashMap<String, String>();
        parames.put(KdtApiProtocol.APP_ID_KEY, appId);
        parames.put(KdtApiProtocol.METHOD_KEY, method);
        parames.put(KdtApiProtocol.TIMESTAMP_KEY, new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(new Date()));
        parames.put(KdtApiProtocol.FORMAT_KEY, format);
        parames.put(KdtApiProtocol.SIGN_METHOD_KEY, signMethod);
        parames.put(KdtApiProtocol.VERSION_KEY, Version);
        return parames;
    }
}

KDTApiTest.java

package cn.zno.youzan;


import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;

import org.apache.http.HttpResponse;


/*
 * 这是个例子
 */
public class KDTApiTest {
    private static final String APP_ID = "yourappid"; //这里换成你的app_id
    private static final String APP_SECRET = "yourappsecret"; //这里换成你的app_secret
    
    public static void main(String[] args){
        sendGet();
//        sendPost();
    }
    
    /*
     * 测试获取单个商品信息
     */
    private static void sendGet(){
        String method = "kdt.ump.coupons.unfinished.all";
        HashMap<String, String> params = new HashMap<String, String>();
//        params.put("num_iid", "2651514");
        
        KdtApiClient kdtApiClient;
        HttpResponse response;
        
        try {
            kdtApiClient = new KdtApiClient(APP_ID, APP_SECRET);
            response = kdtApiClient.get(method, params);
            System.out.println("Response Code : " + response.getStatusLine().getStatusCode());
            BufferedReader bufferedReader = new BufferedReader(new InputStreamReader(response.getEntity().getContent()));
            StringBuffer result = new StringBuffer();
            String line = "";
            while ((line = bufferedReader.readLine()) != null) {
                result.append(line);
            }

            System.out.println(result.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
    
    /*
     * 测试获取添加商品
     */
    private static void sendPost(){
        String method = "kdt.item.add";
        HashMap<String, String> params = new HashMap<String, String>();
        params.put("price", "999.01");
        params.put("title", "测试商品");
        params.put("desc", "这是一个号商铺");
        params.put("is_virtual", "0");
        params.put("post_fee", "10.01");
        params.put("sku_properties", "");
        params.put("sku_quantities", "");
        params.put("sku_prices", "");
        params.put("sku_outer_ids", "");
        String fileKey = "images[]";
        List<String> filePaths = new ArrayList<String>();
        filePaths.add("/Users/xuexiaozhe/Desktop/1.png");
        filePaths.add("/Users/xuexiaozhe/Desktop/2.png");
        
        KdtApiClient kdtApiClient;
        HttpResponse response;
        
        try {
            kdtApiClient = new KdtApiClient(APP_ID, APP_SECRET);
            response = kdtApiClient.post(method, params, filePaths, fileKey);
            System.out.println("Response Code : " + response.getStatusLine().getStatusCode());
            BufferedReader bufferedReader = new BufferedReader(new InputStreamReader(response.getEntity().getContent()));
            StringBuffer result = new StringBuffer();
            String line = "";
            while ((line = bufferedReader.readLine()) != null) {
                result.append(line);
            }

            System.out.println(result.toString());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

问：AppID 和 AppSecert 如何获取？

答：签名通讯协议链接，或者 营销 - 有赞API - 有赞API信息

调用 kdt.ump.coupons.unfinished.all 结果举例：

{
    "response": {
        "coupons": [
            {
                "group_id": "1365546",
                "coupon_type": "PROMOCODE",
                "range_type": "ALL",
                "title": "张三搞活动",
                "value": "0.10",
                "is_random": 0,
                "value_random_to": "0.00",
                "need_user_level": 0,
                "user_level_name": "",
                "quota": 1,
                "is_at_least": 1,
                "at_least": "1.00",
                "total": 10,
                "stock": 10,
                "start_at": "2016-07-26 11:08:50",
                "end_at": "2016-07-31 11:07:41",
                "expire_notice": 0,
                "description": "这是张三的活动优惠码",
                "is_forbid_preference": 0,
                "is_sync_weixin": 0,
                "weixin_card_id": "",
                "status": 0,
                "is_share": 1,
                "fetch_url": "https://wap.koudaitong.com/v2/showcase/promocode/fetch?alias=a8fdmtq2",
                "stat_fetch_user_num": 0,
                "stat_fetch_num": 0,
                "stat_use_num": 0,
                "created": "2016-07-26 11:11:04"
            }
        ]
    }
}

优惠劵优惠码接口举例说明：

kdt.ump.coupon.consume.verifylogs.get 获取优惠券/优惠码核销记录
kdt.ump.coupon.consume.get 根据核销码获取优惠券/优惠码

或者获取所有未开始和正在进行的优惠劵/优惠码

kdt.ump.coupons.unfinished.all