《浙江联通行业应用短信平台二次开发接口使用手册》由会员分享，可在线阅读，更多相关《浙江联通行业应用短信平台二次开发接口使用手册（20页珍藏版）》请在金锄头文库上搜索。
1、文件版本：V1.0.070201发布时间：2007.02.01浙江联通行业应用短信平台二次开发接口使用手册（V1.0）中国联通浙江分公司增值业务部2007.02浙江联通行业应用短信平台二次开发接口使用手册Copyright 2004-2008，中国联通浙江分公司研发中心 注意事项：1、 本手册介绍浙江联通行业应用短信平台的二次开发接口的安装调试方法。如果需要对帐号进行日常管理（如子帐号管理、费用查询、客户端下载发送短信等） ，请登录到网站http:/ 上进行操作。这方面的操作指南请参考网页界面的使用手册。2、 如果您需要快速定位问题，请直接查阅第 5 节的“常见问题解答（FAQ） ”。1简介1
2、.1 系统的结构和特点浙江联通行业应用短信平台具备二次开发接口（后面简称接口或接口软件） ，接口软件在整个方案中的位置如下图中蓝色部分所示，在安装了接口软件以后，企业内部所有的短信应用系统只要对接口数据库进行数据存储，就能完成收发短信的工作，并且可以查询到所发送短信当前的状态，避免了企业内部软件开发人员在 CMPP、SMPP 等短信通讯协议上浪费大量的人力和物力。和使用 API 接口在 CMPP 或 SMPP 协议层次上开发短信应用程序相比，企业直接使用本系统提供的数据库接口开发短信应用程序，可以至少节省一个开发小组几个月的工作量，在时间就是金钱的现代社会，本系统为企业带来的时间效益是惊人的。
3、图例：绿色箭头采用 SGIP 或 SMPP 协议传输短信的链路红色箭头采用加密数据包传输短信的链路本系统采用了各种方法保证企业短信收发的安全性和稳定性： 信息加密：和浙江联通行业短信平台接口服务器之间的通讯不采用 CMPP、SMPP 等非加密的协议，而是在短消息传送的过程中进行加密传输，保证了信息的安全性。企业内部网络浙江联通内部网络短信中心短信网关互联网专线 短信接口软件杭州联通行业应用短信平台服务器短信接口数据库应用系统 1应用系统 2应用系统 n用户手机浙江联通行业应用短信平台二次开发接口使用手册Copyright 2004-2008，中国联通浙江分公司研发中心 断线重连：软件具备断线自
4、动重连的功能，当因为网络异常等各种原因造成链路中断时，软件能够自动重复尝试连接，以保证短信收发的及时性和可靠性。 免维护：接口服务软件采用系统服务的方式在后台运行，无须用户干预，即使遇到服务器断电等异常情况，只要按动电源按钮重新将计算机开机，软件即可自动运行。接口软件和企业内部的短信应用系统之间采用容易编程的数据库接口，使开发人员能够以最简便的方式实现最强大的功能： 发送简单方便：软件自动对接口数据库进行扫描，企业内部的短信应用系统只要将短信发送号码和内容保存到接口数据库里面，就可以将短信发送到用户的手机上。 状态可查询：软件自动接收短信网关返回的短信状态报告，并将状态保存到接口数据库中，企业
5、内部的短信应用程序只要查询数据库，就可以得知短信的当前状态。 信息双向交流：当用户向企业发送短信时，软件自动从服务器端接收短信并保存到接口数据库中，其他应用程序只要查询接口数据库，就可以获取该短信。 号码扩展：企业可以对短信号码进行多达 8 位的扩展，便于多个内部应用系统同时通过该接口收发短信，真正实现一点接入，多点使用。 支持广泛：现在最新版本的短信接口服务软件已经支持最常用的 Oracle、SQLServer 和 Sybase数据库。1.2 运行环境接口软件的运行环境为： 硬件要求：CPU PIII 700 以上，内存 128M 软件要求：Windows 2000/XP，如果接口数据库使用
6、 Oracle，则需安装 Oracle 客户端软件。和软件配套使用的接口数据库可以使用 Oracle、SQL Server 或 Sybase 三种类型，接口数据库和接口服务软件既可以安装在不同的计算机上，也可以安装在同一台计算机上，如果两者安装在同一台服务器上，那么服务器的硬件配置应该相应提高。建议采用下列配置的专用服务器： 双 P4 1600 CPU，1G 内存，36.4G x 2 热插拔硬盘（Raid1）浙江联通行业应用短信平台二次开发接口使用手册Copyright 2004-2008，中国联通浙江分公司研发中心2数据库的安装和配置在安装接口服务软件之前，需要首先安装数据库并初始化接口表，
7、下面的内容将分Oracle、SQLServer 和 Sybase 数据库三种类型分别说明如何创建接口表。2.1 使用 Oracle 数据库在使用 Oracle 数据库的情况下，最好为短信接口表单独设置一个表空间，并为其单独分配一个用户，以便和其他短信应用系统使用的数据表隔离。2.1.1 数据字典下面是短信接口表的初始化脚本，各字段的取值和含义已经包含在字段的注释中：- - 系统范围内唯一的 ID，容量：10 位整数- drop sequence sms_seq;create sequence sms_seqincrement by 1start with 1maxvalue 999999999
8、9nocache;- - 数据库版本表- ! 请不要增加、删除或者修改本表的记录 !- drop table sms_ver cascade constraints;create table sms_ver (ver number(2) - 数据库结构版本号);insert into sms_ver values(1);commit;- - 短信接收表- drop table sms_receive cascade constraints;create table sms_receive(浙江联通行业应用短信平台二次开发接口使用手册Copyright 2004-2008，中国联通浙江分公司研发
9、中心id number(10) primary key, - 唯一 id，取自 sms_seq 序列result char(1) default 0, - 供用户程序使用，表示记录是否被处理，缺省为0mobile varchar2(21) not null, - 发送方的手机号码recv_time varchar2(20), - 短信接收时间sms_number varchar2(10), - 扩展短号（用户发送的号码去除公司短号后的扩展部分）content varchar2(160) - 接收的短信内容);create index idx_sms_receive_result on sms_
10、receive(result);create index idx_sms_receive_mobile on sms_receive(mobile);create index idx_sms_receive_sms_number on sms_receive(sms_number);- - 短信发送表- drop table sms_send cascade constraints;create table sms_send(mobile varchar2(21) not null, - 要发送的手机号码content varchar2(160), - 要发送的短信内容sms_number v
11、archar2(10), - 要发送的扩展短号（自动添加在公司短信号码后面）id number(10) primary key, - 唯一 id，取自 sms_seq 序列priority number(1) default 9, - 发送优先级，0 最高plan_time varchar2(19),- 短信定时发送时间，格式为 yyyy-mm-dd hh24:mi:ss- 如果不填写，表示马上发送- *- 上面的字段由发送者填写- 下面的字段由接口回填- *result char(1) default 0, - 状态- 0 等待提交，表示短信尚未提交到短信群发平台的服务器- 1 已提交，表示
12、短信已经提交到短信群发服务器，但是尚未发送到网关- 2 已发送，表示短信已经发送到网关，等待用户接收- 3 已接收，表示用户的手机已经收到短信- a 提交错误，短信被短信群发服务器拒绝- b 发送错误，短信被网关拒绝- c 接收错误，因为用户关机等原因，短信最终未被用户收到- ! 注意 ! ：- 接口服务程序扫描 result=0的记录并发送，然后根据结果更新 result 字段- 如果在 sms_send 表上面建触发器，请严格测试，保证 result 从 0 更新到其他- 状态的语句不会执行失败，否则该条记录会被接口服务程序重复扫描到并- 一直重复发送 !seq_id varchar2(1
13、0), - 短信编号submit_time varchar2(20), - 提交时间send_time varchar2(20), - 网关发送时间浙江联通行业应用短信平台二次开发接口使用手册Copyright 2004-2008，中国联通浙江分公司研发中心recv_time varchar2(20), - 用户接收时间send_type char(1) - 保留);create index idx_sms_send_priority on sms_send(priority);create index idx_sms_send_time on sms_send(plan_time);crea
14、te index idx_sms_send_result on sms_send(result);create index idx_sms_send_seq_id on sms_send(seq_id);create index idx_sms_send_mobile on sms_send(mobile);2.1.2 示范 SQL 语句下面是短信应用程序收发短信以及查询短信状态的 SQL 语句示范： 发送短信：假设浙江联通分配给用户的企业短信号码是 7016571xxx，那么用户可以在此号码的基础上以7016571xxxyyyyy 号码为主叫号码向手机发送短信，其中 yyyyy 为 0 位到 8 位的扩展号码。下面的第 1 条 SQL 语句以 7016571xxx 号码向 13305710000 发送短信“您好！” ；第 2 条 SQL语句以 7016571xxx1234 号码向 13305710000 发送短信“Hello!” ；第 3 条 SQL 语句以7016571xxx6789 号码向 13305710000 发送短信“您好” ，发送时
