彩信接口支持中国移动、中国联通、中国电信的全国范围手机号码。
√ 发送图文、影音彩信;
√ 单发或群发;
√ 支持行业及广告营销类内容;
√ 支持定时发送;
√ 小规模免审自动群发。
http://api.weimi.cc/2/mms/send.html https://api.weimi.cc/2/mms/send.html
POST
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
uid | String | 是 | hQuI****YqKC | 微米账号的UID代码,登录后台可查询 |
pas | String | 是 | Id****9 | 微米账号的接口密码,登录后台可查询 |
mob | String | 是 | 1391*******,138******** | 目标手机号码,多个以“,”分隔 |
sub | String | 是 | 【来自微米网】祝您生活愉快、工作顺心 | 彩信标题 |
con | String | 是 | 彩信内容,详情请参考以下章节 | |
timing | String | 否 | 2012-10-11 18:30:00 | 定时任务计划,时间格式:yyyy-MM-dd HH:mm:ss |
type | String | 否 | json | 接口返回类型:json、xml、txt。默认值为txt |
彩信接口最多接受10帧内容,提交10帧以上自动忽略,不同帧以“;”(半角)分隔,每一帧不同类型内容以“,”分隔。如:“1,txt,AHGZ0eXAzZ3A0AAACAGlzb21pc28yM2dwNA;jpg, xZZxcvzzYRfKx+wkalH5fdmTtqd;2,3gp,dfXG2TE49J0nLUwEEEPoPB/64HweJ/4R6D5v/rmQQwQcWBwB4HweJ”。(以上仅是参数格式举例,非真实数据)
public static String encode(byte[] data) { BASE64Encoder encoder = new BASE64Encoder(); return encoder.encodeBuffer(data); } public static byte[] decode(String str) { BASE64Decoder dec = new BASE64Decoder(); try { return dec.decodeBuffer(str); } catch (Exception e) { return null; } }
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
code | Number | 是 | 0 | 结果代码 |
msg | String | 是 | 发送成功 | 结果描述 |
json格式: {"code":0,"msg":"发送成功"} xml格式: <result> <code>-3</code> <msg>IP鉴权失败</msg> </result>
代码 | 结果描述 | 解决方案 |
0 | 发送成功 | 非常好,继续发送下一条 |
-1 | 参数不正确 | 确认是否遗漏必须传入的参数,以及格式和编码是否正确 |
-2 | 彩信内容解析失败 | 彩信内容格式及内容排序不正确,请参考正确的内容编写规则 |
-3 | 非法账号 | UID及密码不正确,或者账号被暂时(或永久)关闭,请联系客服 |
-4 | IP鉴权失败 | 在合法的IP上调用接口,或将该IP添加为鉴权IP |
-5 | 账号余额不足 | 请在线充值 |
-6 | 彩信内容容量过大 | 通过接口下发彩信的内容不要超过50K,或联系客服 |
-7 | 下发失败 | 系统异常造成,请稍后重试 |
-8 | 内容含有非法关键字 | 请根据返回结果中提示的非法关键字,重新调整内容 |
-9 | 同一个号码、同一段内容,在同一小时内重复下发 | 为了避免对手机用户的骚扰,请避免类似下发,或联系客服 |
-12 | 定时计划时间不正确 | 重新确认定时计划时间格式及有效性,并重新设置 |
-13 | 一次性提交手机号码过多 | GET方式一次性提交号码不要超过100条,POST方式不要超过1万条 |
-15 | 您的IP地址提交错误过多 | 您的IP地址提交错误过多,被平台拦截 |
-16 | 接口调用错误次数太多 | 接口调用错误次数太多,请联系在线客服 |
-17 | 短信模板提交时间错误 | 请在短信模板规定的工作时间内调用 |
√ 接口调用,一定按照POST方式提交,而非GET。
√ 利用微米网的账号,通过登录http://www.weimi.cc,随时获取账号的余额及发送情况,接口调用的数据,也同样可以浏览。但彩信内容,不在“彩信模版”中保留。
√ 彩信接口的内容最大容量50K。
√ timing的时间格式填写不正确会导致下发失败。
√ 开发文档
√ 短信接口
√ 账户余额查询接口
√ PHP示例
√ Java示例
√ Python示例
√ C#示例