彩信接口 文档


彩信接口

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

彩信下发接口详情

接口主要功能

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

 

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

 

请参考

√ 开发文档

√ 短信接口

√ 账户余额查询接口

√ PHP示例

√ Java示例

√ Python示例

√ Node.js示例

√ C#示例

 

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