一、彩信发送
调用地址:
http://www.tui3.com/api/mmssend/?k=发送密钥&r=执行结果格式&t=接收手机号
title=彩信标题(utf8格式)&content=彩信内容&md5=彩信内容的md5值
参数说明:
k: 32位随机值,由系统自动产生,该值请到产品配置中获取。该值请注意安全保管,勿泄露。
p: 1:“实时通道1”; 2:“实时通道2”。
r: 调用后返回的结果格式。json(默认) xml
t:接收手机列表,多个手机号码请用,分隔(最多支持100个手机号)
title:utf8格式彩信标题
md5:彩信内容的md5值(执行base64编码前的md5sum)
以上参数可以用GET或者POST提交
content: 彩信内容,因为彩信内容较长,所以,此内容只能以POST方式传递
内容为 base64 编码后的 TMS 文件。
TMS格式文档说明下载:http://www.tui3.com/docs/tmsformat.doc(内含C#生成TMS文件的演示代码)
返回结果(XML格式,JSON和此相同):
<result>
<err_code>错误代码</err_code> // 0:正确处理
<err_msg>错误描述</err_msg> // err_code非0时返回错误描述字符串
<mms_count>数量</mms_count> // 彩信数量=正确的手机号数量
<tick_ids>id</tick_ids> //发送后返回的查询ID。如果为多个手机号,则返回多个id,中间用, 分隔
<remain_count>剩余彩信数量</remain_count>
</result>
注:因为是异步发送(收到发送请求后立刻返回,由系统其它进程负责发送),所以返回的 remain_count 并非精确值。
二、余额查询
调用地址:http://www.tui3.com/api/query/?k=密钥&r=执行结果格式
返回结果:
<result>
<err_code>错误代码</err_code> // 0:正确处理
<err_msg>错误描述</err_msg> // err_code非0时返回错误描述字符串
<count1>推信剩余数量</count1>
<count2>推信DIY剩余数量</count2>
<count2>彩信剩余数量</count2>
</result>
三、彩信发送状态
本系统支持两种彩信发送状态查询,一为PUSH模式,系统发送短信后,推送状态到用户设置好的接收地址。详见:短信通知接口
第二种为查询模式:
调用地址:http://www.tui3.com/api/mmsstatus/?k=密钥&r=执行结果格式&tick_ids=id列表
说明:用户调用API发送短信时,记录下发送的 tick_ids, 做为参数进行状态查询(id 间用逗号分隔,最多查询100条记录的状态)
返回结果:
<result>
<err_code>错误代码</err_code> // 0:正确处理
<err_msg>错误描述</err_msg> // err_code非0时返回错误描述字符串
<list>
<status>
<id>tickid</id>
<success>成功状态标志</success> //1:成功; 0:失败
<request_time>收到请求的时间</request_time>
<process_time>处理请求的时间</process_time>
<process_flag>处理状态</process_flag> // 0: 收到请求 1:准备发送 2:处理完成
<memo>描述</memo>
</status>
....
</list>
</result>
memo描述:
104:Tms内容异常
116:Mix格式彩信增加Smil文件错误
118:超过该产品的TMS内容长度限制
113:接收号码被过滤,【过滤类型】:【过滤号码】,【过滤类型】:【过滤号码】………..
过滤类型:1.号码异常 2.号码归属省份异常 3.黑名单用户
四、错误代码:
0:正常
1:服务未开通
2:非法KEY
3:IP地址非法
4:无合法接收手机号码
5:md5值检查失败
6:彩信内容上传到发送池中发生错误
7:
8:余额不足
9:批量处理超过限额
10:参数不正确
大于100:其它错误
五、演示代码下载
PHP代码下载:http://www.tui3.com/docs/mmsdemophp.rar


