欢迎访问

深圳新锐信息科技有限公司

网站

1、        彩信接口

1.1.    WebService

接口地址:url/webService/mmsOper?wsdl

说明:该地址是短信服务平台提供的服务地址,其中只需要修改url部分;

例如:http://sz.iveng.com/sms/webService/mmsOper?wsdl

1.1.1.      自定义数据结构

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.1.2.      彩信下行(发送多条内容相同的彩信)

下发彩信共分为两步, 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输出参数,小于零是表示错误,详情见错误码


1.1.3.      获取状态报告

调用间隔时间不小于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.1.4.      彩信webservice错误码

-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:账户没有接口权限


 
<
线

商盟客服 >
您好,欢迎莅临我们的网站,欢迎咨询...

  • 黄经理: 点击这里给我发消息