简单对接抖音小店的接口

最近公司需要对接抖音小店的接口。然后其实对接起来还是蛮简单的，不过自己阅读文档的能力还有点问题，所以这里记录一下开发遇到的问题。

文档地址：https://op.jinritemai.com/docs/guide-docs/6/14

首先是需要准备的配置。

抖音小店的整个流程分两步，第一步先获取他们的access_token，因为调用接口的时候需要附带这个token作为url的参数去调用的，不然会报错。然后第二步就是上面说的再去正式调参。

所以我的做法是写了一个定时每隔10分钟去调用一次token。官方文档找不到了，所以我就贴下自己的方法，下图。

 

拿到了token保存到缓存就可以写接下来的代码了。

https://op.jinritemai.com/docs/guide-docs/10/23

官方文档说他们接口get，post都能调用。我也试了确实可以。调用接口的时候主要碰到的问题是拼参数的问题。因为我开始为了偷懒，就直接用字符串拼接了，但是他们的param格式是Map 的字符串 {"id": "0"}，所以在拼的时候就很容易出错。因为你要拼成这种格式需要这样写string param = "{\"id\": \"0\"}";。参数一个还行，多了就很容易出错，所以推荐用map然后转jsonObject再转字符串。这样就不会出错了。

然后我也推荐用treeMap去做为容器去装。因为treeMap再插入值的时候会对key进行排序。因为官方文档说明了param需要key从小到大排序，而treeMap也满足了这点要求。

然后抖店接口还有个sign值的参数。他是由很多参数加到一起然后加密的一个字符串，然后这个sign值在调用接口的时候是需要一同带过去的。

然后这个requestStr在拼接的时候也是需要将他的key值从大到小去排序。下面是加密方式，这个官方文档也是有的。

然后得到上述这些就可以去调用抖店的接口了。下面贴个简单的订单列表接口实例（其实确实蛮简单的，但是坑还是有的）

流程就是先拿到token，再拿到当前时间（其实好像不是当前时间也可以），然后根据他的method, param, date去获取sign（/order/list就是这个接口的api，然后order.list就是接口的method，文档都有：https://op.jinritemai.com/docs/api-docs/15/55）

然后我这里json和date做了下转换是因为参数怕会有什么特殊字符，所以要转义一下。

然后就可以拼好url了（url + param）然后用http请求就行。

全部代码：

package com.xxx.mall.core.utils;

import com.alibaba.fastjson.JSONObject;
import com.xxx.mall.common.DoudianConstant;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

import java.io.UnsupportedEncodingException;
import java.math.BigInteger;
import java.net.URLEncoder;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;
import java.util.TreeMap;


public class DouDianUtils {

    /**
     * 抖店接口域名
     */
    private static final String DOUDIAN_URL = "https://openapi-fxg.jinritemai.com";
    /**
     * app key
     */
    private static final String APP_KEY = "your app key";
    /**
     * app secret
     */
    private static final String APP_SECRET = "your app secret";
    /**
     * 抖店cache的cacheName
     */
    private static final String DOUDIAN_CACHE_NAME = "doudianCache";
    /**
     * 抖店cache的cacheKey
     */
    private static final String DOUDIAN_TOKEN_KEY = "doudian_access_token";

    /**
     * 通过api取accessToken
     */
    public static void fetchAccessToken() {
        String url = DOUDIAN_URL + "/oauth2/access_token" + "?app_id=" + APP_KEY + "&app_secret="
                + APP_SECRET + "&grant_type=authorization_self";
        String response = HttpUtils.httpGet(url, 20000);
        if (StringUtils.isBlank(response)) {
            for (int i = 0; i < 3; i++) {
                response = HttpUtils.httpGet(url, 20000);
                if (StringUtils.isNotBlank(response)) {
                    break;
                }
                try {
                    Thread.sleep(1000);
                } catch (InterruptedException e) {
                    e.printStackTrace();
                }
            }
        }
        JSONObject jsonObject = JSONObject.parseObject(response);
        if (jsonObject.getIntValue("err_no") == 0) {
            JSONObject data = jsonObject.getJSONObject("data");
            if (null != data) {
                //用于调用API的access_token
                String accessToken = data.getString("access_token");
                if (StringUtils.isNotBlank(accessToken)) {
                    CacheUtil.put(DOUDIAN_CACHE_NAME, DOUDIAN_TOKEN_KEY, accessToken);
                }
            }
        }
    }

    /**
     * 获取 输入参数签名结果 sign
     *
     * @param methodName 方法名
     * @param paramJson 传参
     * @param timeStamp 时间戳
     * @return sign
     */
    public static String fetchSign(String methodName, String paramJson, String timeStamp) {
        String requestStr = APP_SECRET + "app_key" + APP_KEY + "method" + methodName + "param_json" + paramJson + "timestamp"
                + timeStamp + "v2" + APP_SECRET;
        return paramToMD5(requestStr);
    }

    /**
     * 将param参数转成MD5
     *
     * @param requestStr 请求参数
     * @return String
     */
    public static String paramToMD5(String requestStr) {
        byte[] secretBytes;
        try {
            secretBytes = MessageDigest.getInstance("md5").digest(
                    requestStr.getBytes());
        } catch (NoSuchAlgorithmException e) {
            throw new RuntimeException("没有这个md5算法！");
        }
        StringBuilder md5code = new StringBuilder(new BigInteger(1, secretBytes).toString(16));
        while (md5code.length() < 32) {
            md5code.insert(0, "0");
        }
        return md5code.toString();
    }

    /**
     * 获取订单列表 支持按照子订单状态和订单的创建时间、更新时间来检索订单，获取订单列表
     *
     * Tips：
     * 此接口做了限流，每个access_token每分钟1000次上限
     * 此接口，page最多返回100页，一页最多100单，故同样的请求，最多能拉到1万单
     * 通过该接口获取到的父订单，会在order_id后面会加上字母A做标识（这里和从店铺后台导出的订单有区别，从店铺后台导出的订单末尾没有A，
     * 但其实际和通过openapi获取的父订单是同一个，如依据运营导出的订单做核对，则请做订单末尾的A相关处理）
     * 如搜索时指定order_status，则搜索维度为子订单，即按照子订单状态搜索，total也为该状态子订单数量。返回结果的json结构不变，仍为父子订单结构，
     * 因此当有父订单包含多子订单时，返回的结构中父订单可能会有重复!
     * 由于订单同步会有延迟，建议在使用open接口拉取订单时，要做缓冲和兜底处理。比如，在今天的6:00去拉取5:30-5:40的数据后（20分钟后拉），明天的6:00时再拉取一次今天5:30-5:40的数据（兜底补拉）
     *
     * 拉订单最好不要100页的拉，要98-99页的拉，100页有的时候会出问题
     * start_time 开始时间
     * end_time 结束时间
     * order_by 1、默认按订单创建时间搜索 2、值为“create_time”：按订单创建时间；值为“update_time”：按订单更新时间
     * @return JSONArray
     * @throws UnsupportedEncodingException
     */
    public static JSONObject fetchOrderList() throws UnsupportedEncodingException {
        Map map = new TreeMap<>();
        map.put("start_time", "2020/08/01 00:00:00");
        map.put("end_time", "2020/10/02 00:00:00");
        map.put("order_by", "create_time");
        String paramJson = JSONObject.toJSONString(map);
        String accessToken = (String) CacheUtil.get(DOUDIAN_CACHE_NAME, DOUDIAN_TOKEN_KEY);
        String url = DOUDIAN_URL + "/order/list";
        Date now = new Date();
        String dateStr = DateUtil.date2Str(now, "yyyy-MM-dd HH:mm:ss");

        String sign = fetchSign("order.list", paramJson, dateStr);
        //转码
        String paramJson2 = URLEncoder.encode(paramJson, "UTF-8");
        String dateStr2 = URLEncoder.encode(dateStr, "UTF-8");
        String param = "?app_key=" + APP_KEY + "&method=" + "order.list" + "&access_token="
                + accessToken + "¶m_json=" + paramJson2 + "×tamp=" + dateStr2 + "&v=2&sign=" + sign;
        String response = HttpUtils.httpGet(url + param, 20000);
        JSONObject jsonObject = JSONObject.parseObject(response);
        if (jsonObject.getIntValue("err_no") == 0) {
            return jsonObject.getJSONObject("data");
        }
        return null;
    }
}

这里只是实例代码，可以根据实际要求优化代码，这就是后面的工作了。

 

=============================================================================================

更新一下遇到新的问题：

批量添加sku的时候（/sku/addAll）,规格id取的是规格项的最上级的id。这里如果有三个sku的话就是拼成8|8|8