2023年7月31日发(作者：)

中国电信短信接入API

使用手册

（DB接口）

中国电信股份XX

XX互联网与增值业务运营中心

2009年10月

目 录 一、引言3

1.1 编写目的3

1.2 背景说明3

1.3 术语定义3

二、概述4

2.1 接口功能4

2.2 接口组成4

3.1 网络结构5

3.2 运行环境6

操作系统6

数据库系统6

3.3 数据队列6

发送队列表6

接收队列表7

回执队列表7

3.4 DB接口开发说明84.1 开发步骤8

三、接口介绍5四、使用指导8

一、引言

1.1 编写目的

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

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

1.2背景说明

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

1.3术语定义

中国电信SMGP协议 全称“中国电信短消息网关协议SMGP”，本文特指其 V版本，集团客户需接入中国电信短信网关时，必须使用此协议进行程序开发，本文中简称“SMGP”或“SMGP协议”。

MT短信

MO短信

短信回执

通过短信接口发往手机终端的短信。

从手机终端发往短信接口接收队列的短信。

有时也称“状态报告”，对于MT 短信，手机终端收到后会返回短信回执给短信接口。回执包含MT 短信是否成功提交到特定手机终端的信息。

二、概述

2.1 接口功能

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

接口主要功能包括：

 支持MT短信的发送。

 支持MO短信的接收。

 支持短信回执的接收。

2.2 接口组成

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

组成部分

各种语言包

功能说明

用于各种语言的API调用，支持目前主流的语言，如：C++，

DotNet，Java，ASP，VB，PowerBuilder，Delphi等。

数据库接口

用于其他系统直接通过访问数据库来进行短信的收发。 三、接口介绍

3.1 网络结构

CDMA终端OA短信中心ERP短信接口CRMCDMA终端SMGP行业短信网关短信中心短信中心其它信息系统集团客户侧网络结构说明：

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 字段名

ID

SM_ID

SRC_ID

MOBILE

CONTENT

数据类型

bigint

bigint

Varchar

Varchar

TEXT

长度

20

20

键

PK

允许空

N

N

N

N

N

Y

自增量

说明

短信ID，用于与RPT匹配

源。

目标手机。

短信内容。

发送时间 SEND_TIME datetime

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

3.3.2接收队列表

此表名为：SMGP_API_MO

字段名

ID

SM_ID

MOBILE

DEST_ID

CONTENT

MO_TIME

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

数据类型

bigint

bigint

Varchar

Varchar

TEXT

Datetime

长度

20

20

20

键

PK

允许空

N

Y

N

N

N

N

自增量

暂未使用

源

目标

短信内容

MO短信的时间

说明

3.3.3回执队列表

此表名为：SMGP_API_RPT

字段名 数据类型 长度 键 允许空 说明 ID

SM_ID

MOBILE

bigint

bigint

Varchar

PK

N

N

N

N

N

N

自增量

短信ID，与MT表的SM_ID匹配

MT短信目标手机

回执编码

回执的说明文字

回执的时间

RPT_CODE

smallint

RPT_DESC

TEXT

SEND_TIME Datetime

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

3.4 DB接口开发说明

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

四、使用指导

4.1 开发步骤

 选择数据库类型

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

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

 配置数据库参数

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

 开发

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

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

 运行

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

2023年7月31日发(作者：)

中国电信短信接入API

使用手册

（DB接口）

中国电信股份XX

XX互联网与增值业务运营中心

2009年10月

目 录 一、引言3

1.1 编写目的3

1.2 背景说明3

1.3 术语定义3

二、概述4

2.1 接口功能4

2.2 接口组成4

3.1 网络结构5

3.2 运行环境6

操作系统6

数据库系统6

3.3 数据队列6

发送队列表6

接收队列表7

回执队列表7

3.4 DB接口开发说明84.1 开发步骤8

三、接口介绍5四、使用指导8

一、引言

1.1 编写目的

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

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

1.2背景说明

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

1.3术语定义

中国电信SMGP协议 全称“中国电信短消息网关协议SMGP”，本文特指其 V版本，集团客户需接入中国电信短信网关时，必须使用此协议进行程序开发，本文中简称“SMGP”或“SMGP协议”。

MT短信

MO短信

短信回执

通过短信接口发往手机终端的短信。

从手机终端发往短信接口接收队列的短信。

有时也称“状态报告”，对于MT 短信，手机终端收到后会返回短信回执给短信接口。回执包含MT 短信是否成功提交到特定手机终端的信息。

二、概述

2.1 接口功能

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

接口主要功能包括：

 支持MT短信的发送。

 支持MO短信的接收。

 支持短信回执的接收。

2.2 接口组成

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

组成部分

各种语言包

功能说明

用于各种语言的API调用，支持目前主流的语言，如：C++，

DotNet，Java，ASP，VB，PowerBuilder，Delphi等。

数据库接口

用于其他系统直接通过访问数据库来进行短信的收发。 三、接口介绍

3.1 网络结构

CDMA终端OA短信中心ERP短信接口CRMCDMA终端SMGP行业短信网关短信中心短信中心其它信息系统集团客户侧网络结构说明：

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 字段名

ID

SM_ID

SRC_ID

MOBILE

CONTENT

数据类型

bigint

bigint

Varchar

Varchar

TEXT

长度

20

20

键

PK

允许空

N

N

N

N

N

Y

自增量

说明

短信ID，用于与RPT匹配

源。

目标手机。

短信内容。

发送时间 SEND_TIME datetime

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

3.3.2接收队列表

此表名为：SMGP_API_MO

字段名

ID

SM_ID

MOBILE

DEST_ID

CONTENT

MO_TIME

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

数据类型

bigint

bigint

Varchar

Varchar

TEXT

Datetime

长度

20

20

20

键

PK

允许空

N

Y

N

N

N

N

自增量

暂未使用

源

目标

短信内容

MO短信的时间

说明

3.3.3回执队列表

此表名为：SMGP_API_RPT

字段名 数据类型 长度 键 允许空 说明 ID

SM_ID

MOBILE

bigint

bigint

Varchar

PK

N

N

N

N

N

N

自增量

短信ID，与MT表的SM_ID匹配

MT短信目标手机

回执编码

回执的说明文字

回执的时间

RPT_CODE

smallint

RPT_DESC

TEXT

SEND_TIME Datetime

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

3.4 DB接口开发说明

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

四、使用指导

4.1 开发步骤

 选择数据库类型

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

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

 配置数据库参数

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

 开发

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

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

 运行

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