中国电信短信接入API使用手册(DB接口)

中国电信短信接入A P I

使用手册

（D B接口）

中国电信股份有限公司

广东互联网及增值业务运营中心

2009年10月

目录

一、引言 (3)

1.1 编写目的 (3)

1.2 背景说明 (3)

1.3 术语定义 (3)

二、概述 (4)

2.1 接口功能 (4)

2.2 接口组成 (4)

三、接口介绍 (5)

3.1 网络结构 (5)

3.2 运行环境 (6)

3.2.1操作系统 (6)

3.2.2数据库系统 (6)

3.3 数据队列 (6)

3.3.1发送队列表 (6)

3.3.2接收队列表 (7)

3.3.3回执队列表 (7)

3.4 DB接口开发说明 (8)

四、使用指导 (8)

4.1 开发步骤 (8)

一、引言

1.1 编写目的

中国电信提供了强大的短信接入机制。本手册用于指导客户利用中国电信提供的短信接口进行其他需要短信功能的新系统开发或原有系统的短信功能扩展。

本手册的阅读对象为需要采用中国电信短信接入API完成客户开发的设计人员与编码人员。

1.2 背景说明

本手册适用于中国电信SMGP协议（V3.0.2）短信网关接入。

1.3 术语定义

二、概述

2.1 接口功能

中国电信短信接入API是根据中国电信SMGP协议开发的，封装后的用户开发接口。接口可降低用户接入开发的难度，提升接入效率。

接口主要功能包括：

⏹支持MT短信的发送。

⏹支持MO短信的接收。

⏹支持短信回执的接收。

2.2 接口组成

中国电信短信接入API包括如下部分：

三、接口介绍

3.1 网络结构

网络结构说明：

1、行业短信网关接入模块：提供到各地短信中心的接入功能，同时与全国

行业应用平台实现互连；

2、行业短信平台业务处理模块：主要完成短信上行和下行的业务处理，短

信下发，无论是单发，还是群发，无论是单个用户，还是多个用户，都

采用下发任务机制实现。

3、行业短信网关置于电信机房，集团客户端可通过互联网或专线与其连接。

4、集团客户端的各类信息系统是通过向接口数据库进行数据读写操作，实

现短信上、下行。

3.2 运行环境

3.2.1操作系统

DB接口程序支持WINDOWS NT/XP/2003/VISTA操作系统，暂不支持LINUX、UNIX等。

3.2.2数据库系统

DB接口自带ACCESS数据库，可在本机架设。

同时可支持MS SQL SERVER、MYSQL等网络数据库，使用网络数据库时，需用户安装相应数据库驱动程序并进行相关设置。

3.3 数据队列

3.3.1发送队列表

此表名为：SMGP_API_MT

外部系统可对此表进行SELECT、INSERT操作。外部系统通过插入1条记录来进行一次MT短信发送。

3.3.2接收队列表

此表名为：SMGP_API_MO

外部系统可对此表进行SELECT、DELETE 操作。外部系统通过SELECT 操作来取出所有已收到的MO短信，取出后的记录通过DELETE操作来删除掉。

3.3.3回执队列表

此表名为：SMGP_API_RPT

外部系统可对此表进行SELECT、DELETE 操作。外部系统通过SELECT 操作来取出所有已返回的短信回执，取出后的记录通过DELETE操作来删除掉。

3.4 DB接口开发说明

系统数据库采用的是GB2312编码格式，外部系统使用DB接口进行开发，往DB 接口写入数据时，应先把编码格式转化成GB2312格式；从DB接口读取数据时，应先把编码格式从GB2312转换成外部系统所需要的格式。

四、使用指导

4.1 开发步骤

●选择数据库类型

DB接口自带ACCESS数据库，可在本机架设。

同时可支持MS SQL SERVER、MYSQL等网络数据库，用户可根据自身系统自由选择。

●配置数据库参数

使用网络数据库时，需用户安装相应的数据库驱动程序并在DB接口程序中进行相应参数设置。

●开发

开发相应程序实现数据库写入、读取等操作。

●测试

接口程序启动成功后，尝试向相关数据表中插入数据进行短信发送，测试发送效果，亦可回复短信进行短信接收测试等。

●运行

在开发、测试完成后，即可正式上线运行所开发的软件。