• 修改模版
    • 请求
    • 请求参数
    • 响应
    • Json响应示例:

    修改模版

    注意:模板成功修改之后需要重新审核才能使用!同时提醒您如果修改了变量,请重新务必测试,以免替换出错!

    HTTP头信息:

    1. Accept:application/json;charset=utf-8;
    2. Content-Type:application/x-www-form-urlencoded;charset=utf-8;

    请求

    URL:https://sms.yunpian.com/v2/tpl/update.json

    注意:海外服务器地址 us.yunpian.com

    访问方式:POST

    请求参数

    参数名类型是否必须描述示例
    apikeyString用户唯一标识9b11127a9701975c734b8aee81ee3526
    tpl_idlong模板id,64位长整形,指定id时返回id对应的模板。未指定时返回所有模板9527
    tpl_contentString模板id,64位长整形。指定id时返回id对应的模板。未指定时返回所有模板模板内容,必须以带符号【】的签名开头【云片网】您的验证码是#code#
    langString国际短信模板所需参数,模板语言:简体 中文zh_cn; 英文en; 繁体中文 zh_tw; 韩文ko,日文 ja; 其他语言 other (其他语言功能需联系在线客服开通)zh_cn
    callbackstring审核结果会向这个地址推送,推送参数如下http://yourreceiveurl_address

    callback推送参数举例

    名称类型描述
    tpl_idstring模板id
    tpl_contentstring模板内容
    check_statusstring//审核状态:CHECKING/SUCCESS/FAIL
    reasonstring审核未通过的原因

    响应

    名称类型描述
    tpl_idstring模板id
    tpl_contentstring模板内容
    check_statusstring//审核状态:CHECKING/SUCCESS/FAIL
    reasonstring审核未通过的原因
    langstring支持语言
    country_codestring支持地区

    Json响应示例:

    情况1: 修改国际短信模板但未修改语言(带参数lang但lang参数不变) 或 把国内短信模板修改为国际短信模板(带参数lang)):

    1. {
    2. "tpl_id": 9527,
    3. "tpl_content": "【云片网】您的验证码是#code#",
    4. "check_status": "CHECKING",
    5. "reason": null,
    6. "lang": "ko",
    7. "country_code": "KR"
    8. }

    情况2:修改了国际短信模板的语言,即lang参数改变):

    1. {
    2. "code": 0,
    3. "msg": "OK",
    4. "template": {
    5. "tpl_id": 9527,
    6. "tpl_content": "【云片网】您的验证码是#code#",
    7. "check_status": "CHECKING",
    8. "reason": null,
    9. "lang": "ja",
    10. "country_code": "JP"
    11. }
    12. }

    情况3:国际短信模板修改为国内短信模板,不带lang参数):

    1. {
    2. "msg": "OK",
    3. "template": {
    4. "tpl_id": 9527,
    5. "tpl_content": "【云片网】您的验证码是#code#",
    6. "check_status": "CHECKING",
    7. "reason": null
    8. }
    9. }

    语言支持说明:

    语言代码支持地区
    英文en全球所有国家地区
    中文简体zh_cn大陆CN、台湾TW、香港HK、澳门MO
    中文繁体zh_tw大陆CN、台湾TW、香港HK、澳门MO、韩国KR
    韩文ko韩国KR
    日文ja日本JP