短信接口二 开发文档



短信接口类型

短信接口有五种:
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

 

HTTP请求方式

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示例

√ Node.js示例

√ C#示例

 

下载文档 | Java示例源代码 | PHP示例源代码 | 我的微米 | 常见问题 | 微米使用流程 | 联系客服