文档中心 > API类目 > 聚石塔API

taobao.jst.sms.signname.create (淘宝短信签名创建接口)

聚石塔短信签名创建接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
add_sms_sign_request TopAddSmsSignRequest 可选 创建签名入参
  • └ sign_name
  • String
  • 必须
  • 测试签名
  • 签名发送自带【】符号,无须添加【】、()、[]符号,避免重复 不支持如“客户服务”、“友情提醒”等过于宽泛内容、不支持“测试”字样的签名
  • └ remark
  • String
  • 必须
  • 场景说明
  • 请输入签名用途(必填)、企业官网链接(可提升通过率)
  • └ sign_source
  • Number
  • 必须
  • 1
  • 0--企事业单位的全程或简称 1--已备案网站 2--已上线APP 3--公众号或小程序 4--电商平台店铺名 5--已注册商标名
  • sign_file_list
  • SmsFileContentDTO []
  • 可选
  • 上传的证明文件
  • └ file_name
  • String
  • 可选
  • fileName
  • 文件名称
  • └ file_size
  • Number
  • 可选
  • 10
  • 文件大小
  • └ file_suffix
  • String
  • 可选
  • png
  • 文件后缀名
  • └ file_contents
  • String
  • 可选
  • /9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjL/wAARCASAAhQDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/
  • 文件Base64转码后的字符串

响应参数

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

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
JstSmsSignnameCreateRequest req = new JstSmsSignnameCreateRequest();
JstSmsSignnameCreateRequest.TopAddSmsSignRequest obj1 = new JstSmsSignnameCreateRequest.TopAddSmsSignRequest();
obj1.setSignName("测试签名");
obj1.setRemark("场景说明");
obj1.setSignSource(1L);
List<JstSmsSignnameCreateRequest.SmsFileContentDTO> list3 = new ArrayList<JstSmsSignnameCreateRequest.SmsFileContentDTO>();
JstSmsSignnameCreateRequest.SmsFileContentDTO obj4 = new JstSmsSignnameCreateRequest.SmsFileContentDTO();
list3.add(obj4);
obj4.setFileName("fileName");
obj4.setFileSize(10L);
obj4.setFileSuffix("png");
obj4.setFileContents("/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/2wBDAQkJCQwLDBgNDRgyIRwhMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjIyMjL/wAARCASAAhQDASIAAhEBAxEB/8QAHwAAAQUBAQEBAQEAAAAAAAAAAAECAwQFBgcICQoL/");
obj1.setSignFileList(list3);
req.setAddSmsSignRequest(obj1);
JstSmsSignnameCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<jst_sms_signname_create_response>
    <r_code>sign_name_duplicate</r_code>
    <r_success>true</r_success>
    <module>true</module>
    <message>签名重复</message>
</jst_sms_signname_create_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部