创建短信签名

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

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

  1. 禁止使用阿里巴巴集团的品牌名称作为签名,包含但不限于天猫、淘宝、聚划算等
  1. 天猫旗舰店的短信签名必须是店铺名称的关键词组合或品牌名,比如店铺名称为:张三男装旗舰店,短信签名建议是店铺名称、品牌词+类目词、品牌词,签名示例可以为:张三男装旗舰店、张三男装、张三

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

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

1.请求参数:

请求URL:

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

参数名 类型 必须 示例值 说明
appid String true uwkahf@jfs92 合作伙伴AppId
timestamp String true 1633618722 当前时间戳
tb_seller_nick String true kingdo 淘宝卖家店铺登录账号,非店铺名称
sign String true 999de41d862efaa6f1084ead3b3ba480 如何计算生成见示例代码
add_sms_sign_request TopAddSmsSignRequest true 见示例 创建签名入参
- - sign_name string true 测试签名 签名发送自带【】符号,无须添加【】、()、[]符号,避免重复 不支持如“客户服务”、“友情提醒”等过于宽泛内容、不支持“测试”字样的签名
- - remark String true 场景说明 请输入签名用途(必填)、企业官网链接(可提升通过率)
– sign_source Number true 4 0:企事业单位的全程或简称 1:已备案网站 2:已上线APP 3:公众号或小程序 4:电商平台店铺名 5:已注册商标名
– sign_file_list SmsFileContentDTO[] false 上传的证明文件
—- file_name String false 文件名称
—- file_size String false 文件大小
—- file_suffix String false 文件后缀名
—- file_contents String false 文件Base64转码后的字符串

add_sms_sign_request请求的json示例

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

2. 请求示例代码(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);

    }    

3. 返回结果

返回成功的情况

{
    "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": ""
}

4. 返回参数说明

名称 类型 示例值 描述
r_code String sign_name_duplicate 错误CODE
r_success Boolean true 请求是否成功
module Boolean true 请求成功
message String 签名重复 失败原因

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

文档更新时间: 2023-03-14 16:44   作者:admin