开发引导

第一步:设置模板

为保证通道提供稳定服务,我们需要您预先提供短信模板,审核通过后才能发送,审核只需要一次。

如果需要添加自定义短信模板,您可以:

1)通过后台添加。登录后进入“模板设置”菜单,进行添加

2)通过接口添加。添加模板介绍请参考:添加模板接口

注意,模板添加后,云片客服将在半小时内进行审核,审核结果会以短信通知您,请耐心等待。

第二步:使用接口发短信

A(推荐):使用智能匹配模式发短信

该接口能自动匹配已经审核通过的模板进行发送。接口介绍请参考:智能匹配模板短信接口

比如,您已经添加过模板:【云片网】您的验证码是#code#,并且已经由云片客服审核通过 那么,内容:【云片网】您的验证码是1234,可以成功匹配到模板并发送。

B(不推荐):使用指定模板模式发短信

1)什么是模板发送?

模板发送是指使用预先设置好短信模板,发送时只提交模板id和变量值,由云片短信平台组装成完整的短信内容进行发送。模板发送接口介绍请参考:模板发送接口

2)模板发送的变量替换流程说明

比如模板id1的默认模板,模板内容为:

【#company#】您的验证码是#code#

调用模板发送接口时需要用POST方式提交两个参数:

tpl_id:1
tpl_value:#code#=1234&#company#=云片网

注意:#code#=1234&#company#=云片网必须作为一个参数值传递

代码形式如:

tpl_value=urlencode("#code#=1234&#company#=云片网")

否则您可能会得到以下错误提示:

code:2,
msg:请求参数格式错误,
detail:参数 tpl_value 格式不正确,
tpl_value模板值中键值必须成对出现

提交后,系统会根据您提交的模板id 1,找到对应的模板内容:

【#company#】您的验证码是#code#

然后,根据tpl_value设置的变量值进行变量替换,即 #code# 替换为1234#company#替换为云片网

最终,您将收到的内容为:

【云片网】您的验证码是1234

其他模板的使用方法类似,设置对应的模板id(tpl_id)和相关的变量值(tpl_value)即可。模板发送接口详细介绍请参考:模板发送接口

第三步:以上两种接口的使用,我们均提供了示例代码供参考,点击查看 代码示例

常见失败请根据接口的返回值或者参考返回值说明进行排查