接口二次开发文档.docx
《接口二次开发文档.docx》由会员分享，可在线阅读，更多相关《接口二次开发文档.docx（48页珍藏版）》请在冰豆网上搜索。
接口二次开发文档
二次开发接口说明
短信二次接口技术
随着移动商务应用和3G无线技术的加速普及和深入发展与用户需求的变化，短信用户群由时尚人群不断向企业、行业用户扩展。
短信作为一种实用、方便、廉价的通信手段，越来越多地成为企业、行业人士日常工作不可或缺的通讯工具；同时，短信应用范围也由通用服务向企业、行业应用领域扩展。
短信应用不再局限于交互游戏等娱乐方式，它已经介入到企业办公、银行、证券、保险、交通、教育、社保、数据采集等领域，已成为企业、行业应用密不可分的一部分。
面向企业、行业的短信业务逐渐成为短信应用的一个重要组成部分，越来越多的企业开始利用短信平台开展各种短信增值业务如：
OA管理系统、短信商业信息发布系统、短信客户关系管理系统、短信呼叫中心、进销存系统、短信防伪、生产管理系统、短信数据采集等。
业务系统、网站、客户管理系统、进销存系统、OA、生产管理系统。
手机也势必会成为企业信息化管理、移动商务办公的又一大信息终端。
支持多种操作体统：
WINDOWS、LINUX、UNIX
支持多种开发语言：
C#、VB、delphi、VC++、ASP、JAVA、.NET等
支持多种开发方式：
WebService、Http协议、数据库引擎
WebService接入模式
WebService发送短信模式
WebService路径：
体统提供17个接口:
注册接口Reg、更改密码接口UpdPwd、修改注册信息UpdReg、
查询余额接口SelSum、发送信息接口Send、接受短信接口Get、
帐号充值接口ChargeUp、注销接口UnReg群发短信接口BatchSend
彩信查询余额接口BalanceMMS彩信群发接口BatchSendMMS
彩信群发错误接口GetReportFailMMS彩信充值接口ChargeUpMMS
彩信接收接口GetMMS彩信发送接口SendMMS代理商增减条数AgentChangeAccount代理商下面的客户注册AgentMakeAccount
注册接口Reg
输入参数：
参数
说明
类型
CorpID
账号
String
Pwd
密码
String
CorpName
企业名称
String
LinkMan
联系人
String
Tel
联系电话
String
Mobile
联系人手机
String
Email
邮件
String
Memo
其他备注
String
输出参数：
输出返回值参数
状态说明
0
注册成功
–1
账号已经注册
–2
其他错误
–3
账号密码不匹配
Ｃ#实例：
try
{
Dxt.LinkWSLinkWs=newdxt.LinkWS（）;
intReS=LinkWs.Reg（CorpID.Text.Trim（）,Pwd.Text.Trim（）,CorpName.Text.Trim（）,LinkMan.Text.Trim（）,Tel.Text.Trim（）,Mobile.Text.Trim（）,Email.Text.Trim（）,Memo.Text.Trim（））;
if（ReS==0）
{
MessageBox.Show（"注册成功"）;
}
elseif（ReS==-1）
{
MessageBox.Show（"帐号已经注册，请先注销！
"）;
}
elseif（ReS==-2）
{
MessageBox.Show（"其他错误！
"）;
}
elseif（ReS==-3）
{
MessageBox.Show（"帐号密码不匹配！
"）;
}
}
catch（System.Net.WebExceptionWebExcp）
{
MessageBox.Show（"网络错误，无法连接到服务器！
"）;
}
更改密码UpPwd
输入参数
参数
说明
类型
CorpID
帐号
String
Pwd
密码
String
NewPwd
新密码
String
输出参数：
输出返回值参数
状态说明
0
密码修改成功
–1
账号未注册
–2
其他错误
–3
密码错误
Ｃ#实例：
try
{
Dxt.LinkWSLinkWs=newDxt.LinkWS（）;
intUpdPwd=LinkWs.Reg（CorpID.Text.Trim（）,Pwd.Text.Trim（）,NewPwd.Text.Trim（））;
if（ReS==0）
{
MessageBox.Show（"密码修改成功"）;
}
elseif（ReS==-1）
{
MessageBox.Show（"账号未注册"）;
}
elseif（ReS==-2）
{
MessageBox.Show（"其他错误！
"）;
}
elseif（ReS==-3）
{
MessageBox.Show（"密码错误！
"）;
}
}
catch（System.Net.WebExceptionWebExcp）
{
MessageBox.Show（"网络错误，无法连接到服务器！
"）;
修改注册信息UpdReg
输入参数：
参数
说明
类型
CorpID
账号
String
Pwd
密码
String
CorpName
企业名称
String
LinkMan
联系人
String
Tel
联系电话
String
Mobile
联系人手机
String
Email
邮件
String
Memo
其他备注
String
输出参数：
输出返回值参数
状态说明
0
修改成功
–1
账号未注册
–2
其他错误
–3
密码错误
Ｃ#实例：
try
{
Dxt.LinkWSLinkWs=newdxt.LinkWS（）;
intReS=LinkWs.UpdReg（CorpID.Text.Trim（）,Pwd.Text.Trim（）,CorpName.Text.Trim（）,LinkMan.Text.Trim（）,Tel.Text.Trim（）,Mobile.Text.Trim（）,Email.Text.Trim（）,Memo.Text.Trim（））;
if（ReS==0）
{
MessageBox.Show（"成功修改注册信息"）;
}
elseif（ReS==-1）
{
MessageBox.Show（"帐号未注册！
"）;
}
elseif（ReS==-2）
{
MessageBox.Show（"其他错误！
"）;
}
elseif（ReS==-3）
{
MessageBox.Show（"帐号密码不匹配！
"）;
}
}
catch（System.Net.WebExceptionWebExcp）
{
MessageBox.Show（"网络错误，无法连接到服务器！
"）;
查询余额SelSum
输入参数
参数
说明
类型
CorpID
帐号
String
Pwd
密码
String
输出参数：
输出返回值参数
状态说明
0
剩余条数
–1
账号未注册
–2
其他错误
–3
密码错误
Ｃ#实例：
try
{
Dxt.LinkWSLinkWs=newdxt.LinkWS（）;
intReS=LinkWs.SelSum（CorpID.Text.Trim（）,Pwd.Text.Trim（））;
if（ReS>=0）
{
MessageBox.Show（"还剩"+ReS.ToString（）+"条"）;
}
elseif（ReS==-1）
{
MessageBox.Show（"帐号未注册！
"）;
}
elseif（ReS==-2）
{
MessageBox.Show（"其他错误！
"）;
}
elseif（ReS==-3）
{
MessageBox.Show（"帐号密码不匹配！
"）;
}
}
catch（System.Net.WebExceptionWebExcp）
{
MessageBox.Show（"网络错误，无法连接到服务器！
"）;
}
发送短信Send
输入参数：
参数
说明
类型
CorpID
账号
String
Pwd
密码
String
Mobile
发送手机号码
String
Content
发送内容
String
Cell
子号
String
SendTime
定时发送时间
String（14）
输出参数：
输出返回值参数
状态说明
0
发送成功
–1
账号未注册
–2
其他错误
–3
密码错误
–4
手机号格式不对
–5
余额不足
–6
定时发送时间不是有效的时间格式
Ｃ#实例：
try
{
Dxt.LinkWSLinkWs=newDxt.LinkWS（）;
intReS=LinkWs.Send（CorpID.Text.Trim（）,Pwd.Text.Trim（）,SendMobile.Text.ToString（）.Trim（）,SendContent.Text.ToString（）.Trim（）,"",SendTime.Text.ToString（）.Trim（））;
if（ReS==0）
{
MessageBox.Show（"发送成功！
"）;
}
elseif（ReS==-1）
{
MessageBox.Show（"帐号未注册！
"）;
}
elseif（ReS==-2）
{
MessageBox.Show（"其他错误！
"）;
}
elseif（ReS==-3）
{
MessageBox.Show（"帐号密码不匹配！
"）;
}
elseif（ReS==-4）
{
MessageBox.Show（"手机号码不正确！
"）;
}
elseif（ReS==-5）
{
MessageBox.Show（"余额不足！
"）;
}
elseif（ReS==-6）
{
MessageBox.Show（"定时发送时间不是有效时间！
"）;
}
elseif（ReS==-7）
{
MessageBox.Show（"禁止10小时之内向同一手机发送相同内容"）;
}
}
catch（System.Net.WebExceptionWebExcp）
{
MessageBox.Show（"网络错误，无法连接到服务器！
"）;
}
群发短信BatchSend
输入参数：
参数
说明
类型
CorpID
账号
String
Pwd
密码
String
Mobile
发送手机号码
String
Content
发送内容
String
Cell
子号
String
SendTime
定时发送时间
String（14）
固定14位长度字符串，比如：
20060912152435代表2006年9月12日15时24分35秒，为空表示立即发送
输出参数：
输出返回值参数
状态说明
0
发送成功进入审核阶段
1
直接发送成功
–1
账号未注册
–2
其他错误
–3
帐号或密码错误
–4
一次提交信息不能超过600个手机号码
–5
余额不足，请先充值
–6
定时发送时间不是有效的时间格式
–8
发送内容需在3到250字之间
-9
发送号码为空
try
{
Dxt.LinkWSLinkWs=newDxt.LinkWS（）;
intR=WSS.BatchSend（CorpID,Pwd,textBox1.Text,textBox2.Text,"",""）;
if（R==0）
{
MessageBox.Show（"发送成功进入审核阶段！
"）;
}
elseif（R==1）
{
MessageBox.Show（"直接发送成功！
！
"）;
}
elseif（R==-1）
{
MessageBox.Show（"帐号未注册！
"）;
}
elseif（R==-2）
{
MessageBox.Show（"其他错误！
"）;
}
elseif（R==-3）
{
MessageBox.Show（"帐号或密码错误！
"）;
}
elseif（R==-4）
{
MessageBox.Show（"一次提交信息不能超过600个手机号码！
"）;
}
elseif（R==-5）
{
MessageBox.Show（"企业号帐户余额不足，请先充值再提交短信息！
"）;
}
elseif（R==-6）
{
MessageBox.Show（"定时发送时间不是有效时间格式！
"）;
}
elseif（R==-8）
{
MessageBox.Show（"发送内容需在3到250个字之间"）;
}
elseif（R==-9）
{
MessageBox.Show（"发送号码为空"）;
}
}
catch（System.Net.WebExceptionWebExcp）
{
MessageBox.Show（"网络错误，无法连接到服务器！
"）;
}
接收短信Get
输入参数
参数
说明
类型
CorpID
帐号
String
Pwd
密码
String
输出参数：
输出返回值参数
状态说明
字符串
接受短信的内容
–1
账号未注册
–2
其他错误
–3
密码错误
返回格式为：
||手机号#上行内容#发送时间#子号||手机号#上行内容#发送时间#子号……
Ｃ#实例：
try
{
Dxt.LinkWSLinkWs=newDxt.LinkWS（）;
stringresult=LinkWs.Get（CorpID.Text.Trim（）,Pwd.Text.Trim（））;
if（result==""）
{
MessageBox.Show（"没有上行信息"）;
}
elseif（result=="-1"）
{
MessageBox.Show（"帐号未注册！
"）;
}
elseif（result=="-2"）
{
MessageBox.Show（"其他错误！
"）;
}
elseif（result=="-3"）
{
MessageBox.Show（"帐号密码不匹配！
"）;
}
else
{
stringReGet="";
result=result.Replace（"||","|"）;
string[]temp=result.Split（"|".ToCharArray（））;
for（inti=0;i{
if（temp[i].Trim（）!
=""）
{
string[]temp1=temp[i].Split（"#".ToCharArray（））;
if（temp1.Length>2）
{
ReGet+="第"+i.ToString（）+"条回复，手机号：
"+temp1[0]+"，内容：
"+temp1[1]+"，回复时间：
"+temp1[2]+"，回复号码：
"+temp1[3]+"\n";
}
}
}
MessageBox.Show（ReGet.ToString（）.Trim（））;
}
}
catch（System.Net.WebExceptionWebExcp）
{
MessageBox.Show（"网络错误，无法连接到服务器！
"）;
帐号充值ChargeUp
输入参数
参数
说明
类型
CorpID
帐号
String
Pwd
密码
String
CardNo
充值卡卡号
String
CardPwd
充值卡密码
String
输出参数：
输出返回值参数
状态说明
0
充值成功
–1
账号未注册
–2
其他错误
–3
密码错误
–7
充值失败
Ｃ#实例：
try
{
Dxt.LinkWSLinkWs=newDxt.LinkWS（）;
intReS=LinkWs.ChargeUp（CorpID.Text.Trim（）,Pwd.Text.Trim（）,CardNo.Text.ToString（）.Trim（）,CardPwd.Text.ToString（）.Trim（））;
if（ReS==0）
{
MessageBox.Show（"充值成功！
"）;
}
elseif（ReS==-1）
{
MessageBox.Show（"帐号未注册！
"）;
}
elseif（ReS==-2）
{
MessageBox.Show（"其他错误！
"）;
}
elseif（ReS==-3）
{
MessageBox.Show（"帐号密码不匹配！
"）;
}
elseif（ReS==-7）
{
MessageBox.Show（"充值失败！
"）;
}
}
catch（System.Net.WebExceptionWebExcp）
{
MessageBox.Show（"网络错误，无法连接到服务器！
"）;
注销UnReg
输入参数
参数
说明
类型
CorpID
帐号
String
Pwd
密码
String
输出参数：
输出返回值参数
状态说明
0
注销成功
–1
账号未注册
–2
其他错误
–3
密码错误
Ｃ#实例：
try
{
Dxt.LinkWSLinkWs=newDxt.LinkWS（）;
intReS=LinkWs.UnReg（CorpID.Text.Trim（）,Pwd.Text.Trim（））;
if（ReS==0）
{
MessageBox.Show（"注销成功"）;
}
elseif（ReS==-1）
{
MessageBox.Show（"帐号未注册！
"）;
}
elseif（ReS==-2）
{
MessageBox.Show（"其他错误！
"）;
}
elseif（ReS==-3）
{
MessageBox.Show（"帐号密码不匹配！
"）;
}
}
catch（System.Net.WebExceptionWebExcp）
{
MessageBox.Show（"网络错误，无法连接到服务器！
"）;
}
彩信余额查询BalanceMMs
输入参数
参数
说明
类型
CorpID
帐号
String
Pwd
密码
String
输出参数：
输出返回值参数
状态说明
整数
成功
错误文本
失败
Ｃ#实例：
Dxt.LinkWSLinkWs=newDxt.LinkWS（）;
stringR=WSS.BalanceMMS（CorpID,Pwd）;
MessageBox.Show（R.ToString（））;
群发彩信接口BatchSendMMS
输入参数：
参数
说明
类型
CorpID
账号
String
Pwd
密码
String
Mobile
发送手机号码（最多600多个号码）
String
Base64Content
发送内容
Tms文件的base64编码
Titlt
标题
String
ExtCode
扩展码需要运营商支持一般为空
String
SendTime
定时发送时间（为空表示及时短信）
String（14）
固定14位长度字符串，比如：
20060912152435代表2006年9月12日15时24分35秒，为空表示立即发送
输出参数：
输出返回值参数
状态说明
Ok
发送成功
错误信息文本
失败
Dxt.LinkWSLinkWs=newDxt.LinkWS（）;
FileStreamFS=newFileStream（openFileDialog1.FileName,FileMode.Open）;
intlen=（int）FS.Length;
byte[]B=newbyte[len];
FS.Read（B,0,len）;
stringB64Content=Convert.ToBase64String（B）;
stringR=WSS.BatchSendMMS（CorpID,Pwd,textBox1.Text,B64Cont
升级会员 