1、榛子云短信注册:http://sms_developer.zhenzikj.com/zhenzisms_user/register.html,进行新建模板审核(24小时内审核)
2、python SDK下载:http://smsow.zhenzikj.com/doc/sdk.html
3、下载后的SDK只包含一个zhenzismsclient.py文件,直接导入到工程中即可使用。
4、代码:
import zhenzismsclient as smsclient#引入模块
client = smsclient.ZhenziSmsClient('https://sms_developer.zhenzikj.com', 'AppId', 'AppSecret')
#AppId应用ID可在应用管理-我的应用下查看
#AppSecret秘钥可在应用管理-我的应用下查看
params = {}
params['number'] = '自己的手机号'#手机号
params['templateId'] = '5602'#短信模板id
params['templateParams'] = ['aaaa','100']#根据短信模板几个占位符,输入几个参数值
print(client.send(params))#查看发送状态
实例:
5、短信结果:
榛子云开发文档:
请求参数
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
templateId | 是 | string | 短信模板ID,登录用户中心,在"短信管理->短信模板"中创建,并查看 |
templateParams | 否 | string[] | 短信模板参数 |
number | 是 | string | 接收者手机号码 |
messageId | 否 | string | messageId即该条短信的唯一标识, 不能重复 |
clientIp | 否 | string | 客户端IP,需要与应用设置中的”客户IP限额“配合使用,主要防止用户恶意刷短信 |
错误代码表
错误码 | 原因 | 解决方案 |
---|---|---|
100 | 参数格式错误 | 检查请求参数是否为空, 或手机号码格式错误 |
101 | 短信内容超过1000字 | 短信内容过长,请筛检或分多次发送 |
105 | appId错误或应用不存在 | 请联系工作人员申请应用或检查appId是否输入错误 |
106 | 应用被禁止 | 请联系工作人员查看原因 |
107 | ip错误 | 如果设置了ip白名单,系统会检查请求服务器的ip地址,已确定是否为安全的来源访问 |
108 | 短信余额不足 | 需要到用户中心进行充值 |
109 | 今日发送超过限额 | 如果设置了日发送数量,则每个接收号码不得超过这个数量 |
110 | 应用秘钥(AppSecret)错误 | 检查AppSecret是否输入错误,或是否已在用户中心进行了秘钥重置 |
111 | 账号不存在 | 请联系工作人员申请账号 |
117 | templateId错误,或者模板未审核 | 错误说明 |
1000 | 系统位置错误 | 请联系工作人员或技术人员检查原因 |