短信接口有五种:
1、短信接口一,自定义短信发送内容,适合:会员群发通知、会员营销群发等,有 人工审核 。点击查看详情
2、短信接口二,通过传入短信模版CID发送短信,适合:验证码、订单短信、物流类、监控类等触发类短信,可以 自动审核下发 。
3、个性化短信群发接口,通过传入短信模版CID发送短信,适合:订单短信、物流类、监控类等触发类短信,可以 自动审核下发 。点击查看详情
4、获取手机用户的短信上行
5、获取短信接收状态
以上五种接口,通过配置和设置不同参数区分使用。
这五种短信接口支持中国移动、中国联通、中国电信的全国范围手机号码。
√ 触发类短信:验证码 、 订单短信 等,调用短信模版,并可以传入定制化参数;验证码类短信请参考下方注意事项中的“验证码类短信规范”
√ 单发或群发;
√ 支持定时发送短信;
√ 可以做到 免审下发 。
√ 试用账号或未完成报备的账号,可以使用临时模板cid:d9Z7uIKCYqhQ
http://api.weimi.cc/2/sms/send.html https://api.weimi.cc/2/sms/send.html
GET 或 POST
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
uid | String | 是 | hQuI****YqKC | 微米账号的UID代码,登录后台可查询 |
pas | String | 是 | Id****9 | 微米账号的接口密码,登录后台可查询 |
mob | String | 是 | 1391*******,138******** | 目标手机号码,多个以“,”分隔 |
cid | String | 是 | d9Z7uIKCYqhQ | 短信模版的CID代码。示例值是临时模板cid,该模板内容:【商讯达】验证码:%P%,3分钟内有效。调用时只需要传一个参数,即:p1={具体验证码} |
p1…pn | String | 否 | 尊敬的用户 | 短信模版的个性化参数,数量由创建模版时决定 |
timing | String | 否 | 2012-10-11 18:30:00 | 定时短信任务计划,时间格式:yyyy-MM-dd HH:mm:ss |
type | String | 否 | json | 接口返回类型:json、xml、txt。默认值为txt |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
code | Number | 是 | 0 | 结果代码 |
msg | String | 是 | 发送成功 | 结果描述 |
json格式: {"code":0,"msg":"发送成功"} xml格式: <result> <code>-3</code> <msg>IP鉴权失败</msg> </result>
代码 | 结果描述 | 解决方案 |
0 | 短信提交成功 | 非常好,继续发送下一条 |
-1 | 参数不正确 | 确认是否遗漏必须传入的参数,以及格式和编码是否正确 |
-2 | 非法账号 | UID及密码不正确,或者账号被暂时(或永久)关闭,请联系客服 |
-3 | IP鉴权失败 | 在合法的IP上调用接口,或将该IP添加为鉴权IP |
-4 | 账号余额不足 | 请在线充值 |
-5 | 下发失败 | 系统异常造成,请稍后重试 |
-6 | 短信内容含有非法关键字 | 请根据返回结果中提示的非法关键字,重新调整短信内容 |
-7 | 同一个号码、同一段短信内容,在同一小时内重复下发 | 为了避免对手机用户的骚扰,请避免类似下发,或联系客服 |
-9 | 短信内容过长 | 短信内容或参数过长,短信内容不要超过500字,验证码模板参数不超过12字。建议每条短信内容字数控制在300字以内。 |
-10 | 定时计划时间不正确 | 重新确认定时计划时间格式及有效性,并重新设置 |
-11 | 非法短信模版CID | 模版CID不正确,或者模版被暂时(或永久)冻结,请联系客服 |
-13 | 一次性提交手机号码过多 | GET方式一次性提交号码不要超过100条,POST方式不要超过1万条 |
-14 | 短信模板提交过快 | 短信模板提交过快,请与客服联系 |
-15 | 您的IP地址提交错误过多 | 您的IP地址提交错误过多,被平台拦截 |
-16 | 接口调用错误次数太多 | 接口调用错误次数太多,请联系在线客服 |
-17 | 短信模板提交时间错误 | 请在短信模板规定的工作时间内调用 |
√ cid与con共存时,优先判断cid。
√ cid对应的短信模版如果通过管理员审核,则该短信无论下发条数多少,均免除审核。如短信模版处于“待审核”状态,也可以调用,但下发短信需要人工审核。
√ p1…pn是短信模版对应的个性化参数,参数数量由短信模版决定,按模版中参数出现的先后次序替换参数内容。
√ 务必注意模板内容中占位符的大小写%P%,以及接口传入个性化参数须要小写,比如:p1。
√ 验证码类短信规范 :
1)每天对同一个手机号码最多发送3~5条验证码;
2)同一个手机号码每条验证码间隔时间至少是1~3分钟;
3)一定要加入图形验证码等手段约束用户频繁调用。
√ 短信模板的一般工作时间 :
1)验证码类、订单类等触发类会员通知短信 7*24小时 不间断服务;
2)会员通知类短信群发 8:00~22:00 ,单条频繁提交,同样视为群发;
3)会员营销类短信群发 9:00~18:00 ,会员营销类群发对起发量有要求,具体数量请联系在线客服。
以上仅作参考,每条短信模板的具体工作时间在报备后确定。
√ 开发文档
√ 彩信接口
√ 账户余额查询接口
√ PHP示例
√ Java示例
√ Python示例
√ C#示例