短信接口一 开发文档



短信接口类型

短信接口有五种:
1、短信接口一,自定义短信发送内容,适合:会员群发通知、会员营销群发等,有 人工审核
2、短信接口二,通过传入短信模版CID发送短信,适合:验证码、订单短信、物流类、监控类等触发类短信,可以 自动审核下发点击查看详情
3、个性化短信群发接口,通过传入短信模版CID发送短信,适合:订单短信、物流类、监控类等触发类短信,可以 自动审核下发点击查看详情
4、获取手机用户的短信上行
5、获取短信接收状态

以上五种接口,通过配置和设置不同参数区分使用。

这五种短信接口支持中国移动中国联通中国电信的全国范围手机号码。


短信接口一详情

接口主要功能

√ 用户自写短信内容,适合:会员群发通知会员营销群发 等;
√ 单发或群发;
√ 支持行业及广告营销类内容;
√ 支持定时发送短信;
√ 小规模数量免审自动下发。
√ 有 人工审核

 

接口地址
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******** 目标手机号码,多个以“,”分隔
con String 【微米】您的验证码是:610912,3分钟内有效。如非您本人操作,可忽略本消息。 短信内容
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 参数不正确 确认是否遗漏必须传入的参数,以及格式和编码是否正确
-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万条
-15 您的IP地址提交错误过多 您的IP地址提交错误过多,被平台拦截
-16 接口调用错误次数太多 接口调用错误次数太多,请联系在线客服

 

注意事项

√ 短信签名规范
    1)短信内容一定要带签名,签名放在短信内容的最前面;
    2)签名格式:【***】,签名内容为三个汉字以上(包括三个);
    3)短信内容不允许双签名,即短信内容里只有一个“【】”。

 


请参考

√ 开发文档

√ 彩信接口

√ 账户余额查询接口

√ PHP示例

√ Java示例

√ Python示例

√ Node.js示例

√ C#示例

 

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