创建短信签名
短信签名创建接口,淘宝短信接口需要传入商家账号,短信的签名和模板都会归属此商家名下.
短信签名均需遵循如下要求:
- 禁止使用阿里巴巴集团的品牌名称作为签名,包含但不限于天猫、淘宝、聚划算等
天猫旗舰店的短信签名必须是店铺名称的关键词组合或品牌名,比如店铺名称为:张三男装旗舰店,短信签名建议是店铺名称、品牌词+类目词、品牌词,签名示例可以为:张三男装旗舰店、张三男装、张三
天猫专营店或专卖店的短信签名必须与店铺名称一致,比如店铺名称为:张三男装专营店,申请的签名为:张三男装专营店
淘宝店的签名为店铺名称+淘宝店或淘宝账户(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字段来判断
文档更新时间: 2024-10-13 20:38 作者:admin