短信模板 API
最近更新:2021-12-15
展开全部

短信模板 API

  • 支持创建、修改、查询和删除短信模板

HTTP 验证

使用 HTTP Basic Authentication 的方式做访问授权。这样整个 API 请求可以使用常见的 HTTP 工具来完成,比如:curl,浏览器插件等;

HTTP Header(头)里加一个字段(Key/Value 对):

Authorization: Basic base64_auth_string
          Authorization: Basic base64_auth_string

        
此代码块在浮窗中显示

其中 base64_auth_string 的生成算法为:base64(appKey:masterSecret),即:对 appKey 加上冒号,加上 masterSecret 拼装起来的字符串,再做 base64 转换。appKey、masterSecret 可以在控制台应用设置中查看。


创建模板 API

功能说明

  • 创建短信模板

调用地址

请求示例

curl --insecure -X POST -v https://api.sms.jpush.cn/v1/templates -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d \ '{ "template": "您好,您的验证码是{{code}},2分钟内有效!", "type": 1, "ttl": 120, "remark": "此模板用于用户注册" }'
          curl --insecure -X POST -v https://api.sms.jpush.cn/v1/templates -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d \
'{
    "template": "您好,您的验证码是{{code}},2分钟内有效!",
    "type": 1,
    "ttl": 120,
    "remark": "此模板用于用户注册"
}'

        
此代码块在浮窗中显示

参数

KEY REQUIRE DESCRIPTION
template TRUE 模板内容
1. 短信内容不超过 350 个字,短信内容包括:签名、正文、退订方式(仅营销短信),创建模版时请预留签名等文字的字数;短信计费规则:70 字按 1 条短信计费,超过 70 字,按 67 字 / 条逐条计费。单个汉字、标点、英文都算一个字、回车记两个字。若短信中包含变量,计费条数以实际发送的字数为准
2. 验证码模版仅支持设置一个变量,且变量名必须为 code
3. 通知、营销短信中,变量名仅支持英文及数字,若含有链接变量,变量名必须为 url ,为避免短信发送时因进入人工审核而导致发送延迟,请在 remark 参数中填写链接以报备,支持不设置参数
type TRUE 模板类型,1 为验证码类,2 为通知类,3 为营销类
ttl FALSE 验证码有效期,必须大于 0 且不超过 86400 ,单位为秒(当模板类型为 1 时必传)
remark FALSE 请简略描述正文模版的发送场景及发送对象,不超过 100 字(remark 中包含链接的情况下需要将链接地址放置在最前,请求才会成功)

返回示例

请求成功

{ "temp_id": 37582 }
          { "temp_id": 37582 }

        
此代码块在浮窗中显示

请求失败

{ "error": { "code": *****, "message": "*****" } }
          {
    "error": {
        "code": *****,
        "message": "*****"
    }
}

        
此代码块在浮窗中显示

修改模板 API

功能说明

  • 修改审核不通过的模板,并再次提交审核

调用地址

请求示例

curl --insecure -X PUT -v https://api.sms.jpush.cn/v1/templates/37582 -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d \ '{ "temp_id": 37582, "template": "您好,您的验证码是{{code}},5分钟内有效!", "type": 1, "ttl": 300, "remark": "此模板用于用户注册" }'
          curl --insecure -X PUT -v https://api.sms.jpush.cn/v1/templates/37582 -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1" -d \
'{
    "temp_id": 37582,
    "template": "您好,您的验证码是{{code}},5分钟内有效!",
    "type": 1,
    "ttl": 300,
    "remark": "此模板用于用户注册"
}'

        
此代码块在浮窗中显示

参数

KEY REQUIRE DESCRIPTION
temp_id TRUE 模板 ID
template TRUE 模板内容
1. 短信内容不超过 350 个字,短信内容包括:签名、正文、退订方式(仅营销短信),创建模版时请预留签名等文字的字数;短信计费规则:70 字按 1 条短信计费,超过 70 字,按 67 字 / 条逐条计费。单个汉字、标点、英文都算一个字、回车记两个字。若短信中包含变量,计费条数以实际发送的字数为准
2. 验证码模版仅支持设置一个变量,且变量名必须为 code
3. 通知、营销短信中,变量名仅支持英文及数字,若含有链接变量,变量名必须为 url ,为避免短信发送时因进入人工审核而导致发送延迟,请在 remark 参数中填写链接以报备,支持不设置参数
type TRUE 模板类型,1 为验证码类,2 为通知类,3 为营销类
ttl FALSE 验证码有效期,必须大于 0 且不超过 86400 ,单位为秒(当模板类型为 1 时必传)
remark FALSE 请简略描述正文模版的发送场景及发送对象,不超过 100 字(remark 中包含链接的情况下需要将链接地址放置在最前,请求才会成功)

返回示例

请求成功

{ "temp_id": 37582 }
          { "temp_id": 37582 }

        
此代码块在浮窗中显示

请求失败

{ "error": { "code": *****, "message": "*****" } }
          {
    "error": {
        "code": *****,
        "message": "*****"
    }
}

        
此代码块在浮窗中显示

查询模板 API

功能说明

  • 查询短信模板

调用地址

请求示例

curl --insecure -X GET -v https://api.sms.jpush.cn/v1/templates/37582 -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1"
          curl --insecure -X GET -v https://api.sms.jpush.cn/v1/templates/37582 -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1"

        
此代码块在浮窗中显示

返回示例

请求成功

{ "temp_id": 37582, "template": "您好,您的验证码是{{code}},5分钟内有效!", "type": 1, "ttl": 300, "remark": "此模板用于用户注册", "status": 1 // 状态,0为审核中,1为审核通过,2为审核不通过 }
          {
  "temp_id": 37582,
  "template": "您好,您的验证码是{{code}},5分钟内有效!",
  "type": 1,
  "ttl": 300,
  "remark": "此模板用于用户注册",
  "status": 1 // 状态,0为审核中,1为审核通过,2为审核不通过
}

        
此代码块在浮窗中显示

请求失败

{ "error": { "code": *****, "message": "*****" } }
          {
    "error": {
        "code": *****,
        "message": "*****"
    }
}

        
此代码块在浮窗中显示

删除模板 API

功能说明

  • 删除短信模板

调用地址

请求示例

curl --insecure -X DELETE -v https://api.sms.jpush.cn/v1/templates/37582 -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1"
          curl --insecure -X DELETE -v https://api.sms.jpush.cn/v1/templates/37582 -H "Content-Type: application/json" -u "7d431e42dfa6a6d693ac2d04:5e987ac6d2e04d95a9d8f0d1"

        
此代码块在浮窗中显示

返回示例

请求成功

HTTP/1.0 200 Content-Type: application/json Content-Length: 0
          HTTP/1.0 200
  Content-Type: application/json
  Content-Length: 0

        
此代码块在浮窗中显示

请求失败

{ "error": { "code": *****, "message": "*****" } }
          {
    "error": {
        "code": *****,
        "message": "*****"
    }
}

        
此代码块在浮窗中显示

返回码

点击查看返回码说明

文档内容是否对您有帮助?

Copyright 2011-2022, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

在文档中心打开