凌凯短信平台二次开发接口文档

2017-07-13    次访问   

 

短信平台二次开发接口文档

V4.0.1

 

 

 

 

 

目录

 

短信平台二次开发接口 1

一、Webservice接口协议 2

(一)短信发送 BatchSend2 2

(二)接收短信 Get 4

(三)查询余额SelSum 6

(四)获取禁止号码NotSend 8

二、HTTPS接口协议 8

(一)短信发送 BatchSend2 8

(二)接收短信 Get 10

(三)查询余额SelSum 10

(四)获取禁止号码NotSend 11

 

 

一、Webservice

  请求地址:

https://IP+Port/ws/LinkWS.asmx(具体接口地址向业务员获取)

(一)短信发送 BatchSend2  

注意:提交短信前请过滤掉重复号码

输入参数:

参数

说明

类型

CorpID

账号

String

Pwd

密码

String

Mobile

发送手机号码(号码之间用英文逗号隔开,建议100个号码) 例如:

13812345678,13519876543,15812349876

String

Content

发送内容

String

Cell

扩展号(必须是数字或为空)

String

SendTime

定时发送时间(可为空)

String(14)

SendTime固定14位长度字符串,比如:20060912152435代表2006年9月12日15时24分35秒,为空表示立即发送

输出返回值参数

状态说明

 大于0的整数

提交成功

–1

账号未注册

–2

其他错误

–3

帐号或密码错误

–5

余额不足,请充值

-7

提交信息末尾签名,请添加中文的企业签名【 】

–6

定时发送时间不是有效的时间格式

–8

发送内容需在1到300字之间

-9

发送号码为空

-10

定时时间不能小于系统当前时间

-11

屏蔽手机号码

-100

IP黑名单

-102

账号黑名单

-103

IP未导白

输出参数:

 

范例:

try

            {

            Dxt.LinkWS LinkWs=new Dxt.LinkWS();

 

            string  Resid = LinkWs.BatchSend(CorpID, Pwd, textBox1.Text, textBox2.Text, "", "");

int R = int.Parse(Resid);

 

            if (R>=0)

            {

            MessageBox.Show("发送成功!!");

            }

            else if(R==-1)

            {

                MessageBox.Show("帐号未注册!");

            }

               else if(R==-2)

            {

                MessageBox.Show("其他错误!");

               }

               else if(R==-3)

               {

                   MessageBox.Show("帐号或密码错误!");

               }

                else if(R==-5)

                {

                    MessageBox.Show("企业号帐户余额不足,请先充值再提交短信息!");

               }

               else if(R==-6)

            {

                   MessageBox.Show("定时发送时间不是有效时间格式!");

               }

               else if(R==-7)

            {

                   MessageBox.Show("提交信息末尾未加签名,请添加中文的企业签名【 】!");

               }

 

                else if(R==-8)

               {

                   MessageBox.Show("发送内容需在1到300个字之间");

                }

                else if(R==-9)

                {

                    MessageBox.Show("发送号码为空");

                    

                }

else if(R==-10)

               {

                   MessageBox.Show("定时时间不能小于当前系统时间!");

               }

else if(R==-101)

               {

                   MessageBox.Show("调用接口速度太快");

               }

 

           }

            catch(System.Net.WebException WebExcp)

           {

               MessageBox.Show("网络错误,无法连接到服务器!");

            }

(二)接收短信 Get

输入参数:

参数

说明

类型

CorpID

帐号

String

Pwd

密码

String

输出参数:

输出返回值参数

状态说明

字符串

接受短信的内容

–1

账号未注册

–2

其他错误

–3

密码错误

-101

调用接口速度太快(大于30s)

-100

IP黑名单

-102

账号黑名单

-103

IP未导白

 

返回格式为:||手机号#上行内容#发送时间#扩展号

            ||手机号#上行内容#发送时间#扩展号……

每次最多取50条,超过50条下次取,不足50条一次就返回完,同一条信息只能取一次,取走后系统自动更改短信标志为【已取】

 

C# 实例:

try

{

Dxt.LinkWS LinkWs=new Dxt.LinkWS();

string result=LinkWs.Get(CorpID.Text.Trim(),Pwd.Text.Trim());

if(result=="")

{

MessageBox.Show("没有上行信息");

}

else if(result=="-1")

{

MessageBox.Show("帐号未注册!") ;

}

else if(result=="-2")

{

MessageBox.Show("其他错误!") ;

}

else if(result=="-3")

{

MessageBox.Show("帐号密码不匹配!" );

}

else

{

string ReGet="";

result=result.Replace("||","|");

string[] temp=result.Split("|".ToCharArray());

for(int i=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.WebException WebExcp)

{

MessageBox.Show("网络错误,无法连接到服务器!" );

 

(三)查询余额SelSum

输入参数:

参数

说明

类型

CorpID

帐号

String

Pwd

密码

String

输出参数:

输出返回值参数

状态说明

0

剩余条数

–1

账号未注册

–2

其他错误

–3

密码错误

-101

调用接口速度太快(大于30s)

-100

IP黑名单

-102

账号黑名单

-103

IP未导白

 

C# 实例:

try

{

Dxt.LinkWS LinkWs=new dxt.LinkWS();

                

int ReS=LinkWs.SelSum(CorpID.Text.Trim(),Pwd.Text.Trim());

if(ReS>=0)

{

MessageBox.Show("还剩"+ReS.ToString()+"条" );

}

else if(ReS==-1)

{

MessageBox.Show("帐号未注册!" );

}

else if(ReS==-2)

{

MessageBox.Show("其他错误!" );

}

else if(ReS==-3)

{

MessageBox.Show("帐号密码不匹配!" );

}

else if(ReS==-101)

{

MessageBox.Show("调用接口频率过应该大于30s一次" );

}

 

}

catch (System.Net.WebException WebExcp)

{

MessageBox.Show("网络错误,无法连接到服务器!" );

               }

 

 

(四)获取禁止号码NotSend

用户可通过接口调用此函数获取最近1小时内屏蔽的手机号码

输入参数:

参数

说明

类型

CorpID

帐号

String

Pwd

密码

String

输出参数:

输出返回值参数

状态说明

字符串

为空或手机号码串(返回值为空表示没有屏蔽号码)

–1

账号未注册

–2

其他错误

–3

密码错误

-101

调用接口速度太快(大于30s)

-100

IP黑名单

-102

账号黑名单

-103

IP未导白

 

返回格式为:1300000001,13000000002,13000000003,13000000004

二、HTTPS

请求地址:

https://IP+Port/ws/ + 函数文件名(具体接口地址向业务员获取)

平台编码:GB2312

提交方式:GET 或者 POST

(一)短信发送 BatchSend2   

 

注意: 提交短信前请过滤掉重复号码

输入参数: 

参数

说明

类型

CorpID

账号

String

Pwd

密码

String

Mobile

发送手机号码(号码之间用英文逗号隔开,建议100个号码)

 例如:13812345678,13519876543,15812349876

String

Content

发送内容

String

Cell

扩展号(必须为数字或为空

String

SendTime

定时发送时间(可为空

String(14)

SendTime固定14位长度字符串,比如:20060912152435代表2006年9月12日15时24分35秒,为空表示立即发送

输出参数:

输出返回值参数

状态说明

 大于0的数字

提交成功

–1

账号未注册

–2

其他错误

–3

帐号或密码错误

–5

余额不足,请充值

–6

定时发送时间不是有效的时间格式

-7

提交信息末尾未签名,请添加中文的企业签名【 】

–8

发送内容需在1到300字之间

-9

发送号码为空

-10

定时时间不能小于系统当前时间

-100

IP黑名单

-102

账号黑名单

-103

IP未导白

 

https://IP+Port/ws/BatchSend2.aspx?CorpID=*&Pwd=*&Mobile=*&Content=*&SendTime=* 

(二)接收短信 Get

输入参数:

参数

说明

类型

CorpID

帐号

String

Pwd

密码

String

输出参数:

输出返回值参数

状态说明

字符串

接受短信的内容

–1

账号未注册

–2

其他错误

–3

密码错误

-101

调用接口频率过快(大于30s调用一次)

-100

IP黑名单

-102

账号黑名单

-103

IP未导白

 

返回格式为:||手机号#上行内容#发送时间#扩展号

            ||手机号#上行内容#发送时间#扩展号……

每次最多取50条,超过50条下次取,不足50条一次就返回完,同一条信息只能取一次,取走后系统自动更改短信标志为【已取】

调用方式:

https://IP+Port/ws/Get.aspx?CorpID=*&Pwd=*

 

(三)查询余额SelSum

输入参数:

参数

说明

类型

CorpID

帐号

String

Pwd

密码

String

 

输出参数:

输出返回值参数

状态说明

 0

剩余条数

–1

账号未注册

–2

其他错误

–3

密码错误

-101

调用接口频率过快(大于30s调用一次)

-100

IP黑名单

-102

账号黑名单

-103

IP未导白

 

调用方式:

https://IP+Port/ws/SelSum.aspx?CorpID=*&Pwd=*

 

(四)获取禁止号码NotSend

用户可通过接口调用此函数获取最近1小时内屏蔽的手机号码

输入参数:

参数

说明

类型

CorpID

帐号

String

Pwd

密码

String

输出参数:

输出返回值参数

状态说明

字符串

为空或手机号码串(返回值为空表示没有屏蔽号码)

–1

账号未注册

–2

其他错误

–3

密码错误

-101

调用接口速度太快(大于30s)

-100

IP黑名单

-102

账号黑名单

-103

IP未导白

 

返回格式为:1300000001,13000000002,13000000003,13000000004

调用方式:

https://IP+Port/ws/NotSend.aspx?CorpID=*&Pwd=*

 

 

 


文章均为思乐科技专注网站建设,成都网站建设的成都网站建设公司原创,转载请注明来自https://www.cdsile.com/news/fuwudayi/2017713/77362.html