金笛短信中间件开发接口说明（WEB版&VC版）

配置完数据源之后，中间件会自动创建 smsserver_in、smsserver_out、smsserver_calls 三张表。

smsserver_out 表，用于存放待发送的短信以及短信的发送结果,将需要发送的短信插入到该表，中间件会自动发送，并将发送结果记录到该表。

smsserver_in 表，中间件收到短信以及状态报告之后，会将其存入该表。

smsserver_calls 表，中间件接到电话之后会将其存入该表。

数据库接口支持的开发语言：java  、C 、C++ 、C# 、PHP 、Ruby 、VB  等一切可以操作数据库的编程语言。

功能测试

金笛短信中间件web版提供了三个url分别用于收发短信和查询短信发送结果。

短信发送 URL：

http://ip:8060/send?password=[ 密 码 ]&text=[ 内 容 ]&recipient=[ 手 机号]&encoding=U&gateway=*

发送参数说明：

ip：安装 web 中间件所在服务器的 ip。

password：发送密码,默认是 1。

text：发送内容，该字段实际设置的是您要发送的内容的 utf8 编码。

recipient：对方手机号码，群发时用逗号分割。

encoding：字符编码集，设置为 U 发送中文短信。

gateway：从哪一个通道发出,*代表不指定，由系统分配。

可选发送参数说明：

priority：优先级，低：负数 普通：0 高：正数

from：发送者名称，部分运营商支持，只针对 GSM modem

返回的结果说明：

举例如下：

成功的例子：

<?xml version="1.0" encoding="UTF-8"?>

<send>

<error>0</error>

<message_status>UNSENT</message_status>

<ref_no>221</ref_no>

<msg_id>2</msg_id>

<gateway>modem1</gateway>

</send>

返回错误码说明：

失败的例子：

<?xml version="1.0" encoding="UTF-8"?>

<send>

<error>-9002</error>

<error_description>Message not sent.</error_description>

<message_status>FAILED</message_status>

<failure_cause>UNKNOWN</failure_cause>

<ref_no>null</ref_no>

<gateway>*</gateway>

</send>

error_description：错误描述

failure_cause：导致发送失败的原因，有以下几种情况：

BAD_NUMBER 号码格式有误

BAD_FORMAT 消息格式不正确

GATEWAY_FAILURE Generic gateway failure - 临时错误，稍后重试

NO_ROUTE 设备没启动或没有设备 

UNKNOWN 未知错误

短信发送状态查询 URL：

http://ip:8060/ sendstatus ?msgid=[msgid]

发送参数说明：

msgid：短信提交成功后返回的 msgid。

返回的结果说明：

短信接收 URL：

http://ip:8060/read?password=[密码]&gateway=modem[设备序号]

接收参数说明：

password：接收密码,默认为 1。

Gateway：短信模块，用于从指定模块接收短信，如果没有指定则从所有模块读取短信。

返回的结果说明：

<?xml version='1.0' encoding="UTF-8"?>

<messages>

<error>0</error>

<message>

<message_type>Inbound</message_type>

<message_date>2012-03-22T14:45:11 08:00</message_date>

<originator>8615101091940</originator>

<text>

<![CDATA[

金笛短信中间件web版httpserver接口

]]>

</text>

<encoding>ENCUCS2</encoding>

<gateway>modem1</gateway>

</message>

</messages>

在 develop 文件夹有 java 的关于 htttpserver 接口收发短信的历程，可以参考一下。

回调功能说明：

对收到的短信进行实时处理，比如通过设备发一条短信，对方收到后回复一条，我需要知道短信内容和发送人，并能进行相应的处理。

1、在配置文件 JDSMSServer.conf 中把这几行注释去掉

#interface.2=http1,HttpPush

#http1.get_url=http://127.0.0.1:8090/test.jsp?gatewayId=%gatewayI

#d%&text=%text%&originator=%originator%

#http1.method=GET

其中，

http1.get_url=http://127.0.0.1:8090/test.jsp 换成您的web服务器的地址和相应的页面，最后重新启动一下服务，其中 Console 文件夹中有对应的 test.jsp 文件可以参考一下。

使用邮件接口的前提条件是：

需要开启邮箱pop3和smtp服务，允许客户端读取短信，邮件内容不能带附件。

web中间件邮件接口是将邮件通过短信方式发送给对方。

标题为手机号或者内容的第一行是手机号，第二行为内容。如果要群发的话，手机号可以用“;”分号进行分隔，由中间件负责把这封邮件转成短信发给邮件中的手机号。

邮件通过短信方式发出后，收件箱中的邮件会自动删除，以免重复发送。（邮箱中只要有邮件，程序就会通过短信的方式发送邮件）。

第一步：修改配置文件

以我本机为例（Linux版本和Windows版本修改配置文件地方一致即可）。

1.1.找到web中间件安装目录，进入conf目录。

1.2打开JDSMSServer.conf配置文件。（要用Notepad++工具打开）

1.3修改前如下：（找到以下红框标记内容。）

1.4修改后如下：

修改完配置文件需要保存一下，然后重启一下web中间件服务。

1.5重启web中间件服务：

打开服务，找到我们web中间件服务名“金笛短信中间件web版服务”

点击“重启动此服务”，或者“停止此服务”再“启动此服务”。

第二步：进行发邮件测试

2.1因为我在配置文件中填写的收件人和发件人分别为：

收件人：chenyd@mailer.com.cn

发件人：sms@mailer.com.cn

我们现在登录邮箱：sms@mailer.com.cn给chenyd@mailer.com.cn发一封邮件进行测试。

2.2测试是否发出短信。

登录web中间件查看邮件是否通过短信方式发出，点击待发送列表可以看到等待发送或者正在发送，过一会发送成功，就会记录在短信记录里面。

手机收到短信格式和邮件格式一样：

这时“chenyd@mailer.com.cn”这个用户中的邮件已经被删除。

配置完数据源之后， 中间件会在数据库中自动创建T_SendTask、T_RecRecord、T_TempRecRecord、T_SentRecord、T_EventLog 五张表。

1.  T_SendTask：指定等待发送队列表信息，将待发短信保存到此表中供组件定时查询

来发送。

2.  T_RecRecord：接收短信表，短信猫将接收到的短信保存到此表中。

3.  T_TempRecRecord：临时接收短信表，短信猫将接收到的长短信的分段短信保存到

此表中。

4.  T_SentRecord：短信已发送状态表，记录发送状态。

5.  T_EventLog：工作事件日志表，将短信猫状态变化、错误信息等写入此表中，可以有效掌握其工作状态。

数据库接口支持的开发语言：java、C、C++、C#、PHP、Ruby、VB 等一切可以操作数据库的编程语言。

功能测试