1688 Signature & Enum

一、语言枚举（country）

多语言是通过country入参，英语："en", 俄语："ru", 越语： "vi", 日语："ja", 韩语： "ko", 法语："fr", 葡萄牙语："pt", 西班牙语： "es"，泰语："th", 印尼语："id"，阿拉伯语："ar"，法语："fr"，开通多语言请联系客服。

二、搜索筛选枚举（filter）

参数示例：filter传入"shipIn24Hours,shipIn48Hours"，多个条件英文逗号分割

综合体验分： 5星（totalEpScoreLv1），4.5星-5.0星（totalEpScoreLv2）， 4星-4.5星（totalEpScoreLv3）， 4星以下（totalEpScoreLv4）

24小时揽收率：<95%（getRate24HLv1）， ≥95%（getRate24HLv2）， ≥99%（getRate24HLv3）

48小时揽收率：<95%（getRate48HLv1）， ≥95%（getRate48HLv2），≥99%（getRate48HLv3）

认证工厂（certifiedFactory） 当日发货（shipInToday）严选 （1688Selection）分销严选（jxhy） 24小时发货（shipIn24Hours） 48小时发货（shipIn48Hours）

7天无理由（noReason7DReturn） 支持一件代发（isOnePsale）支持一件代发包邮（ isOnePsaleFreePost） 7天上新（new7 ）30天上新（new30）

全球严选（isQqyx）跨境select货盘（isSelect）

三、搜索排序条件（sort）

参数示例：sort传入{"price":"asc"}，asc-升序 desc-降序，枚举值：批发价price，复购率rePurchaseRate，月销量monthSold

四、榜单rankType支持的字段

complex综合榜，hot热销榜，goodPrice好价榜，anchorHot主播热卖榜，anchorNew主播新兴榜，anchorRecommend主播热推榜

VNHot越南热销榜，VNTrend越南趋势榜

五、TagInfo枚举

isOnePsale一件代发，isOnePsaleFreePostage一件代发包邮，isSupportMix混批，noReason7DReturn7天无理由退货，1688_yx1688严选，new77天上新

new3030天上新，isQqyx全球严选，select跨境select货盘

六、API接口签名规则(sign)

1.接口签名规则(sign)：

/**
 * sign签名字符串生成规则
 */
public static String getSignString(Map<String, Object> params, String secret) {
    // 删除sign签名字段
    params.remove("sign");

    // 由于map是无序的，这里主要是对key进行排序（字典序）
    Set<String> keySet = params.keySet();
    String[] keyArr = keySet.toArray(new String[keySet.size()]);

    // 字典排序
    Arrays.sort(keyArr);

    StringBuilder sbd = new StringBuilder();
    for (String k : keyArr) {
        if (Optional.ofNullable(params.get(k)).isPresent()) {
            sbd.append(k).append("=").append(params.get(k)).append("&");
        }
    }

    // secret最后拼接
    sbd.append("secret=").append(secret);
    return sbd.toString();
}

/**
 * 对生成的sign字符串做MD5加密
 * 字符串转大写
 */
public static String getMD5String(String str) {
    try {
        MessageDigest md = MessageDigest.getInstance("MD5");
        byte[] digest = md.digest(str.getBytes());
        StringBuilder sb = new StringBuilder();
        for (byte b : digest) {
            sb.append(String.format("%02x", b));
        }
        return sb.toString().toUpperCase();
    } catch (Exception e) {
        return null;
    }
}

2.针对 POST-json 请求接口签名简化规则：
由于json结构体可能嵌套多个层级，签名时对各个层级字段的顺序要求必须一致，容易导致签名认证失败，特提供简化版认证规则，即在原先请求的 json 结构体增加requestTime字段即可

/**
* 请求的appkey
*/
@NotNull(message = "参数: appkey不能为空")
protected String appKey;

/**
* 请求的时间戳
*/
@NotNull(message = "参数: requestTime不能为空")
protected String requestTime;

/**
* 请求签名
*/
@NotNull(message = "参数: sign不能为空")
protected String sign;