注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 阿里大于API

alibaba.aliqin.fc.digitalsms.createtemplate (数字短信模板创建)

数字短信模板创建

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
template_name String 必须 ****模板 模板名称
template_contents DigitalSmsTemplateContentDto [] 必须
  • 最大列表长度:20
  • 系统自动生成
    • └ file_suffix
    • String
    • 必须
    • txt
    • 文件后缀名,文字内容转成txt,图片支持gif、jpg、png格式,音频支持mp3格式,视频支持mp4格式,目前只支持上传一个视频文件
    • └ file_name
    • String
    • 必须
    • file-1.txt
    • 文件名称,请带上后缀
    • └ file_size
    • Number
    • 必须
    • 1840901
    • 文件大小,单位:字节
    • └ file_contents
    • String
    • 必须
    • 字符
    • 文件二进制数组转base64,转的时候指定编码格式为UTF-8
    apply_remark String 必须 ***业务需要 申请说明

    响应参数

    名称 类型 示例值 描述
    result Result 0 返回值
    • └ err_code
    • String
    • 0
    • 错误码
    • └ success
    • Boolean
    • false
    • true表示成功,false表示失败
    • └ msg
    • String
    • 成功
    • 返回信息描述
    • └ model
    • String
    • DIGITAL_SMS_*****
    • 模板code

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaAliqinFcDigitalsmsCreatetemplateRequest req = new AlibabaAliqinFcDigitalsmsCreatetemplateRequest();
    req.setTemplateName("****模板");
    List<AlibabaAliqinFcDigitalsmsCreatetemplateRequest.DigitalSmsTemplateContentDto> list2 = new ArrayList<AlibabaAliqinFcDigitalsmsCreatetemplateRequest.DigitalSmsTemplateContentDto>();
    AlibabaAliqinFcDigitalsmsCreatetemplateRequest.DigitalSmsTemplateContentDto obj3 = new AlibabaAliqinFcDigitalsmsCreatetemplateRequest.DigitalSmsTemplateContentDto();
    list2.add(obj3);
    obj3.setFileSuffix("txt");
    obj3.setFileName("file-1.txt");
    obj3.setFileSize(1840901L);
    obj3.setFileContents("字符");
    req.setTemplateContents(list2);
    req.setApplyRemark("***业务需要");
    AlibabaAliqinFcDigitalsmsCreatetemplateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_aliqin_fc_digitalsms_createtemplate_response>
        <result>
            <err_code>0</err_code>
            <success>false</success>
            <msg>成功</msg>
            <model>DIGITAL_SMS_*****</model>
        </result>
    </alibaba_aliqin_fc_digitalsms_createtemplate_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.ERROR_EMPTY_CONTENT 数字短信内容为空 检查template_contents参数是否传参
    isv.ERROR_INVALID_FILETYPE 数字短信不支持的文件类型 检查传入的file_suffix文件后缀是否是可支持的,文字内容转成txt,图片支持gif、jpg、png格式,音频支持mp3格式,视频支持mp4格式
    isv.ERROR_UPLOAD_OSS 数字短信上传文件失败 数字短信中的内容上传文件服务器有误,请检查文件内容是否太多,或者有误
    isv.ERROR_FILE_SIZE_LIMIT 数字短信文件总大小超限 上传的文件内容大小,总共不能超过2M,不包括2M
    isv.ERROR_FILE_NAME 数字短信文件名为空 请检查入参中file_name文件名,是否有输入
    isv.ERROR_FILE_SUFFIX 数字短信文件后缀为空 请检查入参中file_suffix文件后缀名,是否有输入
    isv.ERROR_CREATE_TEMPLATE_ERROR 数字短信模板创建有误 请联系开发人员具体排查

    API工具

    如何获得此API

    FAQ

    返回
    顶部