接口地址:url/webService/mmsOper?wsdl
说明:该地址是短信服务平台提供的服务地址,其中只需要修改url部分;
例如:http://sz.iveng.com/sms/webService/mmsOper?wsdl
MmsFileGroup(输入参数,彩信数据)
参数名称 |
类型 |
说明 |
playTime |
Integer |
本帧播放时间。 |
txtPosition |
Integer |
本帧文字位置 1,图下;2,图上。 |
text_FileName |
String |
本帧文本文件名(如aa.txt),如果本帧有文字,则需添加。 |
text_FileData |
String |
本帧文本内容,如果本帧有文字,则需添加。BASE64编码 |
image_FileName |
String |
本帧图片文件名(如bb.jpg),如果本帧有图片,则需添加。 |
image_FileData |
String |
本帧图片内容,如果本帧有图片,则需添加。BASE64编码 |
audio_FileName |
String |
本帧音频文件名(如2.mid),如果本帧有音频,则需添加。 |
audio_FileData |
String |
本帧音频内容,如果本帧有音频,则需添加。BASE64编码 |
下发彩信共分为两步, 1 上传彩信,服务端返回产品id。2 利用第1步产生的产品id 下发彩信(产品id可以重复使用,即一次上传,多次发送)。
1) 上传彩信产品
两种方式上传彩信,1上传彩信数据,数据结构见定义:MmsFileGroup,数组方式上传。数组的每个下标 index 代表第 index +1帧数据;2直接上传彩信产品,将一个完整的彩信产品压缩成zip文件,再将该zip文件用 BASE64编码上传,该彩信产品必须要包含正确的smil文件,以及对应的所有素材文件(包括文本图片等),否则可能不会正常下发。
A)
名称 |
upMms |
功能 |
上传彩信。 |
接口方法 |
upMms(String account, String password, String subject,MmsFileGroup[] mmsFileGroup, StringHoldermmsproductID,StringHoldererrMsg) |
输入说明 |
account用户账号; password用户密码(用MD5加密,32位,加密后字母全部为小写,例如:“123.com“加密后应该等于“cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确); subject彩信标题(小于30个字符) mmsFileGroup对象,见自定义数据结构(彩信数据) |
输出说明 |
productID输出参数,上传成功的场合,服务端返回的产品id, errMsg输出参数,小于零是表示错误,详情见错误码 |
B)
名称 |
upMmsZipfile |
功能 |
上传彩信(zip方式)。 |
接口方法 |
upMmsZipfile(String account, String password, String subject,StringzipFileData, StringHoldermmsproductID, StringHoldererrMsg) |
输入说明 |
account用户账号; password用户密码(用MD5加密); subject彩信标题 zipFileData彩信数据,彩信文件压缩成zip文件,在对该文件进行BASE64编码 |
输出说明 |
productID输出参数,上传成功的场合,服务端返回的产品id, errMsg输出参数,小于零时表示错误,详情见错误码 |
2) 下发彩信
名称 |
sendMms |
功能 |
上传彩信。 |
接口方法 |
sendMms(String account, String password, String productID, String mmsType, Date sendTime, String inPhones, StringHolderresMsg,StringHoldererrMsg) |
输入说明 |
account用户账号; password用户密码(用MD5加密,32位,加密后字母全部为小写,例如:“123.com“加密后应该等于“cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确); productID彩信产品id(由上传彩信upMms或者upMmsZipfile返回) mmsType彩信业务类型 sendTime下发时间,可为空(默认为当前时间) inPhones下发号码,多个号码用半角逗号“,”分割 |
输出说明 |
resMsg输出参数,提交彩信成功的场合,服务端返回, 格式(无换行符): <sendResp> <mms> <phone>15000792799</phone> <mmsID>2c9281e22c051940012c05194a210001</mmsID> </mms> <mms> <phone>13585987970</phone> <mmsID>2c9281e22c051940012c05194a210001</mmsID> </mms> </sendResp> errMsg输出参数,小于零是表示错误,详情见错误码 |
调用间隔时间不小于30秒。
名称 |
getMmsReport |
功能 |
上传彩信。 |
接口方法 |
getMmsReport(String account, String password,StringHolderresponseStr,StringHoldererrMsg) |
输入说明 |
account用户账号; password用户密码(用MD5加密,32位,加密后字母全部为小写,例如:“123.com“加密后应该等于“cbff36039c3d0212b3e34c23dcde1456”可以用此例子验证加密方法是否正确); |
输出说明 |
responseStr输出参数,下发彩信的状态报告, 格式(无换行符): <mmsReport> <mms> <phone>15000792799</phone> <mmsID>2c9281e22c05117f012c0511894d0001</mmsID> <stat>0</stat></mms> </mmsReport> 说明: Stat:状态 0表示成功,其他失败。 注:返回值是那些有状态报告的彩信,暂时没有状态报告的彩信不会返回,一般原因有: 等待发送;正在发送;已经提交到网关,还没有从网关返回状态报告等,如果状态没有返回,则需等待一段时间后,再次重新获取取状态报告。 errMsg输出参数,小于零时表示错误,详情见错误码 |
-1:用户帐号空(account)
-2:用户密码空(password)
-3:彩信标题空(subject),或者大于ZUI大字符限制数(30个)
-4:彩信数据空(mmsFileGroup)
-5:账户登录失败,请检查用户名或者密码是否正确
-6:账户被禁用
-7:彩信数据不正确(没有数据,或则过大,不能大于50K)
-8:没有smil文件,或者文件不正确(通过第二种方式上传彩信时)
-9:产品id 空(productID,下发彩信时)
-10:彩信产品不存在:请检查彩信产品id是否正确,或则重新上传彩信产品
-11:下发号码空或错误(inPhones)
-12:下发彩信提交失败(通常是因为下发号码中,有的号码不正确,是黑名单用户,等原因)
-13:需要获取状态报告的输入参数空(reportStats,需要获取状态报告时,必须要输入彩信id
和下发号码,才能获取对应的状态报告)
-14:需要获取状态报告的输入参数大于100 (reportStats的长度大于100,一次只能取小于等
于100个状态报告)
-15:客户端ip地址不正确(当需要ip校验时)
-16:下发号码数量大于指定值(一次只能提交100个号码)
-17:彩信业务类型不正确
-18:账户没有接口权限