跳转到内容
Cheeli 文档
返回官网

短信签名创建接口

短信签名创建接口,淘宝短信接口需要传入商家账号,短信的签名和模板都会归属此商家名下.

短信签名均需遵循如下要求：

  1. 禁止使用阿里巴巴集团的品牌名称作为签名，包含但不限于天猫、淘宝、聚划算等

  2. 天猫旗舰店的短信签名必须是店铺名称的关键词组合或品牌名，比如店铺名称为：张三男装旗舰店，短信签名建议是店铺名称、品牌词+类目词、品牌词，签名示例可以为：张三男装旗舰店、张三男装、张三

  3. 天猫专营店或专卖店的短信签名必须与店铺名称一致，比如店铺名称为：张三男装专营店，申请的签名为：张三男装专营店

  4. 淘宝店的签名为店铺名称+淘宝店或淘宝账户(sellerNick)+淘宝店,比如淘宝的店铺名称为：张三男装，需要申请的签名为：张三男装淘宝店

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/taobao/jst/sms/sign/create

参数名类型必须示例值说明
appidStringtrueuwkahf@jfs92合作伙伴AppId
timestampStringtrue1633618722当前时间戳
tb_seller_nickStringtruekingdo淘宝卖家店铺登录账号，非店铺名称
signStringtrue999de41d862efaa6f1084ead3b3ba480如何计算生成见示例代码
add_sms_sign_requestTopAddSmsSignRequesttrue见示例创建签名入参
- - sign_namestringtrue测试签名签名发送自带【】符号，无须添加【】、()、[]符号，避免重复 不支持如“客户服务”、“友情提醒”等过于宽泛内容、不支持“测试”字样的签名
- - remarkStringtrue场景说明请输入签名用途（必填）、企业官网链接（可提升通过率）
– sign_sourceNumbertrue40:企事业单位的全程或简称 1:已备案网站 2:已上线APP 3:公众号或小程序 4:电商平台店铺名 5:已注册商标名
– sign_file_listSmsFileContentDTO[]false上传的证明文件
—- file_nameStringfalse文件名称
—- file_sizeStringfalse文件大小
—- file_suffixStringfalse文件后缀名
—- file_contentsStringfalse文件Base64转码后的字符串

add_sms_sign_request请求的json示例

{
    "sign_name": "迈步鞋城淘宝店",
    "remark": "给用户发送订单通知等",
    "sign_source": 4
}

二、请求示例代码

Java

@Test
    public void  JstSmsSignnameCreateRequest() throws Exception {
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("tb_seller_nick", Config.TBSellerNick);


        JSONObject jsonObject = new JSONObject();
        jsonObject.put("sign_name", "迈步鞋城淘宝店");
        jsonObject.put("remark", "给用户发送订单通知等");
        jsonObject.put("sign_source", 4);
        // 上传证明，若需要
//        JSONArray files = new JSONArray();
//        JSONObject fileItem = new JSONObject();
//        fileItem.put("file_name", "商标名");
//        String base64ImageLogo = Utils.getBase64ImageFromBinary("/Users/demo/bl.jpg");
//        fileItem.put("file_contents", base64ImageLogo);
//        files.add(fileItem);
//        jsonObject.put("sign_file_list", files);
        data.put("add_sms_sign_request", jsonObject.toJSONString());
        // 签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        // 调用服务API
        doHttpRequest(Config.JstSmsSignnameCreateRequestUrl ,data);


    }

三、返回结果

返回成功的情况

{
    "code": 0,
    "message": "ok",
    "data": {
        "module": true,
        "r_success": true,
        "request_id": "15rvednbrtkjo"
    },
    "trace_id": ""
}

返回失败的情况

{
    "code": 0,
    "message": "ok",
    "data": {
        "message": "签名重复。",
        "r_code": "sign_name_duplicate",
        "r_success": false,
        "request_id": "16keujysy4wcs"
    },
    "trace_id": ""
}

四、返回参数说明

名称类型示例值描述
r_codeStringsign_name_duplicate错误CODE
r_successBooleantrue请求是否成功
moduleBooleantrue请求成功
messageString签名重复失败原因

说明： code为0表示成功，非0为失败，message会包含失败原因。业务成功根据r_success字段来判断