简单对接抖音小店的接口

原文:https://blog.csdn.net/qq_39509597/article/details/109147209

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

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

首先是需要准备的配置。

简单对接抖音小店的接口_第1张图片

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

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

简单对接抖音小店的接口_第2张图片

拿到了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也满足了这点要求。

简单对接抖音小店的接口_第3张图片

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

简单对接抖音小店的接口_第4张图片

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

简单对接抖音小店的接口_第5张图片

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

简单对接抖音小店的接口_第6张图片

简单对接抖音小店的接口_第7张图片

流程就是先拿到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.guangeryi.mall.core.utils;
 
import com.alibaba.fastjson.JSONObject;
import com.guangeryi.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

简单对接抖音小店的接口_第8张图片

简单对接抖音小店的接口_第9张图片

你可能感兴趣的:(JAVA开发,java)