推立方彩信API

一、彩信发送

调用地址:
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

API全文下载:http://www.tui3.com/download/Tui3MMSSDK.zip