欢迎访问
深圳新锐信息科技有限公司
网站
深圳新锐信息科技有限公司
主营： 短信接口 API短信接口 APP短信接口
咨询热线电话
主营： 短信接口 API短信接口 APP短信接口
咨询热线电话
接口地址：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：账户没有接口权限
