彩信接口

彩信接口文档

彩信接口支持中国移动、中国联通、中国电信的全国范围手机号码。

彩信下发接口详情

接口主要功能

√ 发送图文、影音彩信；
√ 单发或群发；
√ 支持行业及广告营销类内容；
√ 支持定时发送；
√ 小规模免审自动群发。

接口地址

http://api.weimi.cc/2/mms/send.html
https://api.weimi.cc/2/mms/send.html

HTTP请求方式

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的时间格式填写不正确会导致下发失败。