网关接口说明
升级说明:(3.01以前支持的功能参看“附二”)
3.06版本支持以下功能(红色文字表示新加功能)
1、 修改信息接收表防止因短信内容过长导致不能保存
2、 添加修改帐户密码的功能
3、 添加余额实时更新的功能
4、 修改了本地发送时不能传递自定义编号(sid)的bug
5、 添加对于mysql的支持,以及对于日志功能的自定义
6、 去掉了群发出错的时候可能导致的程序异常关闭
7、 去掉了网络中断重新连接后出现的“check fee error”的错误
8、 添加对本地发送时的发送延时设置
9、 添加本地发送时的状态报告的功能
10、 添加无线发送时对于平台通知的读取
11、 去掉在3.02启动的时候可能出现的错误
12、 支持非手机号码账号
13、 去掉可能出现异常关闭
14、 短信息接收时间为实际接收的时间而不是取系统时间
15、 修正了3.05版发送wap短信不正常的问题
16、 支持64个短信通道
一、 概述
梦网短信猫网关程序提供数据库、TCP/IP、COM RS232三种形式的接口,接口结构简单可靠,方便用户快速有效的进行短信功能的集成,同时可以平滑支持梦网网络功能。其结构图如下:
用户程序
VC,VB,Delphi,PB,
CBuilder等
MonGate.exe
1、 数据库接口
2、 TCP/IP接口
3、 串口COM RS232接口
梦网短信猫
2口、4口、8口 …
目前MonGate.exe只支持Windows平台。
数据库接口通过一个中间的数据库,实现用户程序与MonGate软件的通信,用户发送时只需要把目标手机和发送信息内容添加到数据库指定的表tb_queue中,MonGate软件会定时扫描这个表,发现有数据,立即发送,并把发送结果保存到tb_history表中。对于接收到的数据,MonGate软件会把它们自动保存到tb_control表中。
TCP/IP接口为用户提供在局域网内的及时通讯功能,它的优点是无需中间数据库,接收和反映速度快。
计算机串口 COM RS232接口方式,可以使网络层并不相同的机器之间进行通信,这样既保证了信息的即时传递,又保证了系统得安全性。
短信猫通过串行口(COM)和计算机相连,或者通过USB虚拟的串行口和计算机相连,我们这里编程都是对串行口进行的,有关串行口的信息可以在计算机系统属性中的设备列表中了解。
运行方式如下:
MONGATE.EXE 程序运行
MONGATE.EXE -S 程序运行,并显示设置界面;如果程序已经运行,则显示程序界面
MONGATE.EXE -H 隐藏程序界面
MONGATE.EXE -Q 退出已运行的程序
注意: 当使用 –S、-H参数时,系统只允许启动一个MonGate软件,直接运行时,可以启动多个MonGate软件。
热键说明:
CTRL+ALT+S 显示程序
CTRL+ALT+H 隐藏程序
二、数据库接口说明
1、MONGATE.EXE 提供数据库接口
2、MG25X_SQLSERVER.SQL SQL Server数据库接口的结构脚本
3、MG25X_MYSQ.SQL MySQL 数据库接口的结构脚本
用户程序通过数据库与MONGATE程序通讯,MONGATE程序与梦网短信猫通讯,实现短信的无线接收和发送。
首先需要有一个数据库用来交换数据,该数据库可以是用户原系统的数据库,也可以重新安装一个SQL Server 服务器软件(数据库可以是任何支持ODBC接口的数据库:如ACCESS、MYSQL、ORACALE等),在这个数据库里添加一个表用作数据发送,另外还可添加一个表,用作发送记录。注:这两个表可以单独使用。
MONGATE通过ODBC建立数据连接,通过以下表交换数据(对于SQL-Server用户可以用MONGATE30X.SQL脚本文件自动建立,不用手工输入)
1、发送队列表
表名:tb_queue
字段:id int 4 自动编号 (1+1)
pno int 4 发送端口号,-1由系统自己决定
0~7 代表8个端口号码 (字段只在通过短信猫发送时
有效,通过网络发送是,本字段无效,添-1即可)
spno char 50 移动端口号码和参数组(双向网络发送时使用)
如:1200123,00********
前面是端口号码,后面是参数组,中间用逗号分开,参数组的说明如下。如果移动端口号码填写为“0”时,系统自动选择单向通道发送。
linkid char 30 匹配码 (网络发送时使用,添0则系统自动处理,
添-1表示强制LINKID为空)
phone text 16 接收手机号码或者号码组
msg char 280 发送信息内容(注:只能发送70个字符,一个汉字和一个西文字符都按1个字符计算)
fee int 4 费率代码/wap push标志
userid char 11 发送者帐号,(短信猫用户可填入 13123456789)
pwd char 6 帐号密码(短信猫用户可填入 111111)
sid char 20 备用编号
主键:id
13326771202 926935
参数组说明
1.参数组固定10个字符,每个字符(0~9之间的数)代表一个参数,没有使用的参数
为*。
2.参数组第1个参数为:指令类别:(0:点播类指令,1:定制类指令(只要是
定制节目,无论是下发包月还是下发免费信息,都要求选择值1),2:取消定
制指令(只真对联通),3:失败指令(只真对联通,例如定制失败和退订失败
),4:联通首次点播包月指令(只在首次建立定制关系时使用,之后按值1发
送即可),默认为0
3.参数组第2个参数为:引起MT消息的原因: (只有联通需要,移动默认设为0):
0-MO点播引起的第一条MT消息;
1-MO点播引起的非第一条MT消息;
2-非MO点播引起的MT消息;(联通包月扣费信息下发时候用)
3-系统反馈引起的MT消息
4.参数组其它参数暂为*(如:00********)
用户自己定义编号说明
该编号提供给用户自定义,会被自动添加到历史数据库中。
对于客服端口用户,自定义编号用 linked,其他类型的用户
示例:
(1)双向端口:(以端口1200为例,发送免费信息)
(自动编号),0,[1200,00******],0,“13825237627”,测试,800100,13888888888,
******,0
(2)单向端口:
(自动编号),0,0,0,“13825237627”,测试,0, 13888888888,******,0
(3)客服端口:
(自动编号),0,0,0,“13825237627”,测试,0, 13888888888,******,0
(4)短信猫:(从2号通道发送)
(自动编号),1,0,0,“13825237627”,测试,0, 13888888888,******,0
其中:
13825237627:接收手机;
测试:信息内容
2、发送历史信息表
表名:tb_history
字段: id int 4 自动编号 (1+1)
stime datetime 8 记录时间
phone char 11 接收手机
pno int 4 发送端口号,-1由系统自己决定
0~7 代表8个端口号码 (字段只在通过短信猫发送时
有效,通过网络发送是,本字段无效,添-1即可)
spno char 20 移动端口号码
linkid char 30 匹配码
msg char 280 发送信息内容
fee int 4 费率,用户指定的收费标准
status char 10 发送状态
userid char 11 发送者帐号
sid char 20 队列编号
主键:id
发送状态描述: 1、成功
2、手机号码错
3、空信息
3、控制(接收)信息库 (部分功能适用于3.00以上版本)
表名:tb_control
字段: id int 4 自动编号 (1+1)
stime datetime 8 提交时间
type int 4 0-查费,1-充值,3-到达信息
detail char 280 提交内容(充值时存放卡号和密码,如:S39016,3214)
result char 280 返回内容(查费返回余额,充值返回"成功"或者"失败")
userid char 20 帐号/信息来源手机
pwd char 6 帐号密码
state int 4 处理状态(提交时为0,处理后为1)
主键:id
信息到达格式: stime=当前时间
type =3
result=信息
detail=网络版本:SP端口号码,匹配码 (注:中间用逗号分隔)
无线版本:MONDEM,存放接收信息的端口号码。
userid=手机号码
state=0
二、TCP/IP接口说明
该系统可以使用TCP/IP方式接收局域网中信息,格式如下:
K13825237627D测试信息[0X0D]
其中"13825237627"为接收手机号码
"测试信息为发送的信息内容"
K 和 D 是定界符
[0X0D]代表十六进制0D,这里用作结束符号
网络连接的端口号可以在程序的设置窗口设定,缺省值为8018
三、串口COM-RS232接口说明
该系统可以使用COM-RS232方式接本地信息,格式如下:
K13825237627D测试信息[0X0D]
其中"13825237627"为接收手机号码
"测试信息"为发送的信息内容
K 和 D 是定界符
[0X0D]代表十六进制0D,这里用作结束符号
串行端口的参数可以在程序的设置窗口设定,缺省值为COM1,9600BPS
附一:网络发送错误信息编号表.
1--[登录错]--用户登陆不成功,
2--[格式错]--提交格式不正确,
3--[费用不足]--用户余额不足时,
4--[号码错]--手机号码不正确时,
5--[计费帐号错]--(计费)用户帐号错误,
6--[计费密码错]--(计费)用户密码错,
7--[用户已停用]--用户已经被停用,
8--[类型不支持]--用户类型不支持该功能,
9--[其它错误9]--其它错误,
10-[企业代码错]--企业代码不正确,
11-[信息超长]--信息内容超长,
12-[不能发联通]--不能发送联通号码,
13-[操作权不够]--操作员权限不够,
14-[费率代码错]--费率不正确,
15-[服务器繁忙]--服务器繁忙,
16-[企业权不够]--企业权限不够,
17-[此时不许发]--此时间段不允许发送,
18-[经销商登错]--经销商用户名或密码错,
19-[手机列表错]--手机列表或规则错误,
21-[没权开停户]--没有开停户权限,
22-[没权改类型]--没有转换用户类型的权限,
23-[没权改所属]--没有修改用户所属经销商的权限,
24-[经销商登错]--经销商用户名或密码错,
25-[操作员登错]--操作员登陆名或密码错误,
26-[无充值用户]--操作员所充值的用户不存在,
27-[无权充商务]--操作员没有充值商务版的权限,
28-[用户没转正]--该用户没有转正不能充值,
29-[无权此通道]--此用户没有权限从此通道发送信息.
30-[不能发移动]--不能发送移动号码.
31-[无号码/段]--手机号码(段)非法.
32-[费率代码错]--用户使用的费率代码错误!
33-[非法关键词]--非法关键词.
35-[不能发多条]--不能发送多个手机
36-[不能发单条]--不能发送单个手机
37-[违规,暂停]--贵账号被暂停使用,请过一段时间再试
99-[其它错]--其它错误.
作为做短信猫的专业公司:广州梦网公司的短信猫郑重承诺:
1 短信猫的选材是原装进口的模块 (硬件一年包修,三月包换)
2 短信猫硬件设备完全自主开发,公司有自己的研发力量,保证产品的稳定性
3 短信猫开发包,开发技术和软件,开发例子免费提供,让您先做接口,再做接入
4 短信猫产品价格全国最具竞争力,性价比最高
5 提供开发的全程技术支持和售后服务
6 遍及全国销售和服务网络
广州梦网科技有限公司产品简介
短信防伪 SP端口号(移动联通小灵通同一个号码)
短信猫 集团短信网关(短信通道)
低价短信广告 集团短信群发软件
短信群发软件 家校产品
免费提供短信猫VC、C++、VB、DELPHI、PB开、JAVA、ASP,COM组件等二次开发接口说明书有具体的开发例子
广州梦网科技有限公司短信部:
联系人:任卫平 经理
电 话:020-88149720 13794425319
传 真:020-87602099
Q Q:426262473
地 址:广州市环市东路498号广发花园柏丽商务中心12C(动物园南门站)
邮 编:510075