中国电信综合业务接入网关_ISAG_开放接口协议03

黄铖斌

CT

国电信企业标准中

CT/T SN RC1 ISAG V1.0.1

公

中

2008-08发布 2008-08实施

兴

司

综合业务接入网关ISAG开放接口协议

MMS

中国电信集团公司

专

用

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

目 录

1适用范围

2引用标准

3缩略语

4服务概述

5序列图

6数据类型

...........................................................................................................................................................4

...........................................................................................................................................................5

................................................................................................................................................................6

...........................................................................................................................................................8

................................................................................................................................................................9

.........................................................................................................................................................10

6.1DS

6.2DI

6.3MR

6.4MURI

6.5MP

7接口定义

ELIVERYTATUS

..................................................................................................................................10

ELIVERYNFORMATION

......................................................................................................................10

ESSAGEEFERENCE

...........................................................................................................................10

ESSAGE

.........................................................................................................................................11

ESSAGERIORITY

...............................................................................................................................11

.........................................................................................................................................................12

7.1接口：SM

ENDESSAGE

.........................................................................................................................12

7.1.1ndMessage

操作：

...............................................................................................................12

7.1.2getMessageDeliveryStatus

操作：

.....................................................................................14

7.2接口：GM

ETESSAGE

...........................................................................................................................15

7.2.1getReceivedMessages

操作：

.............................................................................................15

7.2.2getMessageURIs

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

前 言

中国电信移动业务网络综合业务接入网关（ISAG）将中国电信的网络能力高度抽象，向CP/SP

提供标准、统一的业务开发接口，支持电信自营增值业务、第三方CP/SP增值业务及企业应用的接

入。

本系列规范由六项规范组成，名称如下：

中国电信移动业务网络综合业务接入网关ISAG技术规范

中国电信移动业务网络综合业务接入网关ISAG开放接口协议

中国电信移动业务网络综合业务接入网关ISAG业务流程规范

中国电信移动业务网络综合业务接入网关ISAG协议映射规范

中国电信移动业务网络综合业务接入网关ISAG业务测试规范

本系统规范主要依据3GPP和OMA的有关规范和信息产业部颁布的相关行业技术标准编制。

本规范解释权属于中国电信集团公司。

本规范起草单位：中国电信股份有限公司上海研究院。

中

- 3 -

兴

公

司

专

用

中国电信移动业务网络综合业务接入网关ISAG设备要求

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

1 适用范围

IT领域的第三方业务提供商可以通过综合业务接入网关访问和使用电信网络的业务能力。本规范

规定了中国电信综合业务接入网关向第三方提供的电信网络业务能力，描述了这些业务能力的应用开发

接口（API），用于指导综合业务接入网关的设计开发及CP/SP接口应用。

本规范适用于中国电信移动业务网络综合业务接入网关（ISAG）的设备提供商及与此相关的内容

提供商、服务提供商。为综合业务接入网关设备制造、工程设计和网络运行、管理和维护等方面提供技

术依据。

中

- 4 -

兴

公

司

专

用

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

2 引用标准

下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件，其随后所有的修改单（不

包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。

1 《中国电信移动增值业务网络技术体制》

2 《中国电信移动业务网络综合业务接入网关技术规范》

3 《中国电信综合业务管理平台流程规范》

4 《中国电信综合业务管理平台接口规范》

5 3GPP,TS 29.198 Open Service Access (OSA); Application Programming Interface (API)

6 Parlay Group, Parlay 4.0 Parlay X Web Services Specification

7 ETSI ES 202 391-2

中

- 5 -

兴

公

司

专

用

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

3 缩略语

缩略语 英文全名 中文全名

BSS Business Support System

应用接口

业务支撑系统

CAMEL应用部分

呼叫控制

核心网

内容提供商

组合业务

域名服务器

API Application Interface

CAP CAMEL Application

CC Call control

CN Core Network

CP Content Provider

DNS Domain Name System

HLR Home Location Register

HTTP Hyper Text Transfer Protocol

IDE Integrated Development Environment

CS Combined Service

MPC Mobile Postioning Center

IN Intelligent Network

司

- 6 -

IP Intelligent Peripheral

ISMAP Integrated Service Management Access

ISMP Integrated Service Management

Protocol

Platform

公

LCS Location Service

MAP Mobile Application Part

MMSC Multimedia MesISAGe Service Center

MDN Mobile Directory Number

NAG Network Access Gateway

OCS Online Charging System

OSS Operation Support System

NMS Network management rver

MMS Multimedia MesISAGe Service

兴

MSC Mobile Switch Center

中

PSOP Provincial Service Operation Platform

PDN Pocket Data Network

PDSN Pocket Data Support Node

ISAG Service Access Gateway

SCE Service Creating Environment

SCF Service Capability Feature

SCS Service Capability Server

SLA Service Level Agreement

Short MesISAGe Gateway Protocol SMGP

SE Service Enabler

专

用

移动定位中心

集成开发环境

智能网

智能外设

定位业务

移动应用部分

移动交换中心

移动用户号码

网络接入网关

在线计费系统

运营支撑系统

分组数据网络

业务接入网关

业务开发环境

业务能力特征

业务引擎

业务层协议

归属位置寄存器

超文本传输协议

综合业务管理接入协议

综合业务管理平台

多媒体消息业务

多媒体消息业务中心

网络管理服务器

省级业务操作平台

分组数据支持节点

业务能力服务器

短消息网关协议

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

SMPP Short MesISAGe Peer-to -peer Protocol

SMS Short MesISAGe Service

SMSC Short MesISAGe Service Center

短消息点到点协议

短消息业务

短消息业务中心

简单网络管理协议

业务提供商

业务交换点

用户设备

统一资源定位器

拜访位置寄存器

虚拟专用网

SNMP Simple network management Protocol

SP Services Provider

SSP Services switch point

UE Ur Equipment

URL Uniform resource localizer

VLR Visit Location Register

VPN Virtual Private Network

WAP Wireless Application Protocol

WAP GW Wireless Application Protocol Gateway

WSDL Web rvice description language

中

兴

- 7 -

公

司

专

用

无线应用协议

WAP网关

网络服务描述语言

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

4 服务概述

当前，为了接收和发送彩信，在写应用时必须使用专门的协议来接入网元（例如，彩信中心MMS-C）

提供的MMS功能。这种方式要求应用开发商对网络有高度的专业知识。本章定义了一种彩信Web

Service，通过使用这个MMS Web Service，应用开发商不需要专门的电信知识，就能调用彩信功能。

应用调用一个API给网络发送一条彩信（参见发送彩信API）。网关采用非同步的通知机制将彩信

为从网络接收彩信，可使用通知机制（参见MMS Notification API）。通知机制更通用：网络发起的

消息被发送到自我管理的应用侧web rvice。与通知相关的提供准则不在此描述。

中

- 8 -

兴

公

司

专

用

递交状态告知应用。

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

5 序列图

图中为彩信服务的应用示例。

用户登录一个卡通图片业务门户网站，为过生日的好友选择祝福卡片，并编辑祝福短信后，点击彩

信发送。图片门户与MMS服务间通过API交互完成彩信的发送。

同时MMS服务会将彩信中心返回的状态报告通知给图片门户，这样用户可通过门户网站查询彩信发

公

司

中

- 9 -

兴

图1. 彩信服务

专

用

送的状态。

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

6 数据类型

6.1 DeliveryStatus

数据类型：枚举

枚举值 描述

DeliveredToNetwork 短消息已成功递交至网络。

DeliveryUncertain 递交状态未知：例如，短消息被发送到另外一个网络。

DeliveryImpossible 无法成功发送；短消息在超时前无法被递交。

MessageWaiting 消息仍在排队等待递交。

DeliveredToTerminal 成功发送至终端。

DeliveryNotificationNotSupported 不支持发送回执功能。

Authpricefailed 鉴权计费失败

DrmError 版权错误

6.2 DeliveryInformation

参数名 参数类型 描述

兴

数据类型：结构

公

xsd:anyURI address 消息接收地址。

DeliveryStatus deliveryStatus 发送状态。

中

参数名 参数类型 描述

6.3 MessageReference

数据类型：结构

xsd:string 指向ISAG中存储的彩信，如接收彩信messageIdentifier

为纯文本则此参数无效。（可选）

messageServiceActivationNumber xsd:string 目的地址。

- 10 -

司

专

用

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

nderAddress xsd:anyURI 发送方地址。

subject xsd:string 彩信的标题。（可选）

priority MessagePriority 优先级，缺省值为Normal。

message xsd:string 若接收彩信为纯文本，则消息体的内容

填写如此参数，当此参数存在时，

messageIdentifier参数无效。

6.4 MessageURI

数据类型：结构

参数名 参数类型 描述

bodyText xsd:string 此域为接收彩信的文本部分。

fileReferences xsd:anyURI 此域为附件数组，数组的内容是彩信 所

[1..unbounded] 有附件的引用地址（URI），这些引用地址

6.5 MessagePriority

数据类型：枚举

枚举值 描述

Default

Low 低的消息优先级。

中

Normal 正常的消息优先级。

High 高的消息优先级。

- 11 -

兴

公

NULL值。如果类型为MessagePriority的参数被标记为‘可

选的’，本参数可应用。

司

直接指向不同文件，如GIF图片，或者是

文本说明。

专

用

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

7 接口定义

7.1 接口：SendMessage

本节以消息调用、参数和数据类型的方式描述了发起能力的集合。本节描述的API，是由业务应用

服务器发起、到业务接入网关的调用：

󰂗 SendMessage：应用发送消息给网关。

󰂗 GetMessageDeliveryStatus：应用获取消息发送状态。

7.1.1 操作：ndMessage

业务触发条件由应用提供商与签约用户进行预先约定，由应用根据业务需要在恰当时刻调用本接

口，给用户发送一条彩信。本消息调用是请求发送一条彩信到一组地址集合，并返回RequestIdentifier

对本消息的发送进行标识。网关根据第三方的要求用notifyMessageDeliveryStatus 返回状态报告，并

使用RequestIdentifier与先前发送的消息相关联。彩信的内容是使用MIME编码作为一个SOAP附件

进行发送。第三方通过ReceiptRequest告知网关是否需要返回状态报告。

7.1.1.1 输入：ndMessageRequest

参数名 参数类型 描述

兴

xsd:anyURI[1..unbounde

d]

xsd:string 发送彩信的源地址。指示消息发送者的地址。

公

address

中

nderAddress

（可选） 本参数指示消息的主题。

subject xsd:string

本参数代表消息的优先级。如果未定义，网

priority MessagePriority

络将基于运营商策略分配一个优先级。（可

选）

charging Common:ChargingInfor

可选参数。指示计费相关信息。

司

- 12 -

彩信接收地址。

本参数是不允许由所有第三方提供商填充

的。网关服务器需要根据特定应用的SLA对

其进行处理，因此本参数的使用可能导致

PolicyException。（可选）

专

用

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

mation

receiptRequest

输入的附件

content MIME格式

和Message一起发送的数据，使用MIME格

式，作为一个SOAP附件被发送。

Common:SimpleReferen

ce

指示是否需要网络侧返回递交状态报告。

7.1.1.2 输出：ndMessageRespon

参数名 参数类型 描述

xsd:string requestIdentifier

标识一个特定的消息发送请求，可用于

getMessageDeliveryStatus消息调用。

最大长度32位；（编码格式：ISAG设

备号（6位）＋预留位“0”+厂商内部

编码）

7.1.1.3 差错

业务异常：

󰂗 SVC0001 – 业务错误。

󰂗 SVC0004 – 非法地址。

󰂗 SVC0006 – 非法组。

中

策略异常：

󰂗 POL0001 – 策略错误。

󰂗 POL0006 – 组不被允许。

󰂗 POL0007 – 嵌套组不被允许。

󰂗 POL0008 – 不允许提交计费信息。

󰂗 POL0900– 不支持群发。

󰂗 POL0907– 不允许群发。

- 13 -

兴

󰂗 SVC0002 – 非法输入值。

公

司

专

用

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

7.1.2 操作：getMessageDeliveryStatus

7.1.2.1 输入：getMessageDeliveryStatusRequest

参数名 参数类型 描述

requestIdentifier xsd:string 标识一个特定的状态请求。

最大长度32位；编码格式：ISAG设备号（6位）

＋预留位“0”+厂商内部编码

7.1.2.2 输出：getMessageDeliveryStatusRespon

参数名 参数类型 描述

result DeliveryInformation[1..unbounded] 以前发送的一组消息

司

- 14 -

公

󰂗 SVC0001 – 业务错误。

󰂗 SVC0002 – 非法输入值。

󰂗 POL0001 – 策略错误。

7.1.2.3 差错

中

业务异常：

策略异常：

兴

专

用

和传送状态。

的状态。每组要素表

现为一条发送的消

息：例如，目的地址

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

7.2 接口：GetMessage

本节以消息调用、参数和数据类型的方式描述了发起能力的集合。本节描述的API，是由业务应用

服务器发起、到业务接入网关的调用：

󰂗 GetReceivedMessages：应用获取消息的参考消息。

󰂗 GetMessageURIs：应用获取指定消息的URIs。

7.2.1 操作：getReceivedMessages

这个操作是使用一个特殊的注册标识符获得一条新的消息。如果注册标识符未被指定，Parlay X

服务器将返回应用发送的所有消息的参考信息。绑定不同注册标识符参数是一个不在线的处理过程。

Parlay X网关不允许使用一个未与应用关联的注册标识符获取消息。应用可设置优先参数（Priority）

级参数省略，则会返回所有的消息信息。

7.2.1.1 输入：getReceivedMessagesRequest

参数名 参数类型 描述

公

参数类型 参数名 描述

registrationIdentifier xsd:string 标识不在线状态的应用接收通知，消息接收根

兴

priority MessagePriority 从Parlay X网关得到的优先消息。所有拥有指

中

7.2.1.2 输出：getReceivedMessagesRespon

result MessageReference [1..unbounded] 包括一组收到根据指

- 15 -

司

接收高优先级的消息，即，如果设置为普通级参数，则会返回普通级别以上的的所有消息。如果该优先

据制定标准。

定优先权和高级优先权的消息都会找回。如果

没有指定，所有消息都将被返回，例如，都同

样指定为低级。（可选）

专

用

󰂗 GetMessage：应用获取整条消息内容。

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

定过滤注册标识符和

优先权的消息。

7.2.1.3 差错

业务异常：

󰂗 SVC0002 – 非法输入值。

策略异常：

󰂗 POL0001 – 策略错误。

7.2.2 操作：getMessageURIs

这个操作将读取消息的不同部分，在 业务接入网关建立本地文件并且返回URI标识。应用可以仅

仅读取每个文件或将其以链接的形式呈现给最终用户。文件的URIs将在协定的时间被激活。

7.2.2.1 输入：getMessageURIsRequest

参数名 参数类型 描述

标识需要获取的消息。 messageRefIdentifier xsd:string

中

参数名 参数类型 描述

7.2.2.2 输出：getMessageURIsRespon

兴

包含完整的信息，例

如，消息的文本部分，

如果存在的话，还会

包含消息附件的文件

列表。

result MessageURI

公

司

- 16 -

专

用

󰂗 SVC0001 – 业务错误。

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

7.2.2.3 差错

业务异常：

󰂗 SVC0001 – 业务错误。

󰂗 SVC0002 – 非法输入值。

策略异常：

󰂗 POL0001 – 策略错误。

7.2.3 操作：getMessage

这个操作将读取整条消息。在返回的消息中，数据以附件形式返回，该附件在SOAP消息中的附

件[7]中定义。

7.2.3.1 输入：getMessageRequest

参数名 参数类型 描述

7.2.3.2 输出：getMessageRespon

参数名 参数类型 描述

无

中

7.2.3.3 差错

业务异常：

󰂗 SVC0001 – 业务错误。

󰂗 SVC0002 – 非法输入值。

策略异常：

- 17 -

兴

公

messageRefIdentifier xsd:string 消息标识。

司

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

󰂗 POL0001 – 策略错误。

7.3 接口：MessageNotification

本节以消息调用、参数和数据类型的方式描述了发起能力的集合。本节描述的API，是由业务接入

网关发起的、到业务应用服务器的调用：

󰂗 NotifyMessageReception：网关将发送到特定号码的消息告知应用。

7.3.1 操作：notifyMessageReception

业务触发条件由应用提供商与运营商进行预先约定，当业务接入网关收到发给特定地址的消息时，

即调用本接口，将消息发送给业务应用服务器。应用web rvice的URI注册是预先约定的。这意味着

在网关应有一个注册机制，能将不同的RegistrationIdentifier参数与应用及其web rvice URI绑定。

当网关收到发送到特定业务激活号码的新消息时，将把消息作为附件通知到应用。

7.3.1.1 输入：notifyMessageReceptionRequest

参数名 参数类型 描述

公

参数类型 参数名 描述

无

Message MessageReference 与接收消息相关的所有信息。

输入的附件

中

7.3.1.2 输出：notifyMessageReceptionRespon

Content Content Content

兴

本参连接到预先注册过的通知的句柄。

RegistrationIdentifier xsd:string

数区分指向同一个应用web rvice的

不同注册。

司

- 18 -

专

用

󰂗 NotifyMessageDeliveryStatus：网关将特定彩信的递交状态告知应用。

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

7.3.1.3 差错

无。

7.3.2 操作：notifyMessageDeliveryReceipt

业务应用服务器先前向网关发送了彩信，网关对该消息的发送分配了一个标识符

RequestIdentifier。当网关获得状态报告时，即调用本接口将彩信的递交状态报告给应用。本接口的调

用是将先前递交彩信的状态报告告知应用，该短消息以RequestIdentifier和DeliveryStatus的组合进行

标识。状态信息在DeliveryInformation中具体描述。

7.3.2.1 输入：notifyMessageDeliveryReceiptRequest

参数名 参数类型 描述

Correlator xsd:string 标识一个特定的彩信状态报告。

DeliveryStatus DeliveryInformation

7.3.2.2 输出：notifyMessageDeliveryReceiptRespon

参数名 参数类型 描述

无

中

7.3.2.3 差错

无。

兴

公

司

- 19 -

专

用

最大长度50位。

是先前被发送的消息的状态，包括消息

的目标地址和它的递交状态。

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

8 差错定义

无。

中

- 20 -

兴

公

司

专

用

综合业务接入网关ISAG开放接口协议

SN RC1 ISAG V1.0.1

9 服务策略

名称 类型 描述

GroupSupport xsd:boolean 是否支持组地址。

NestedGroupSupport xsd:boolean 是否支持嵌套组。

ChargingSupported xsd:boolean 是否支持计费。

AllowEndPoint xsd:boolean 是否允许指定地址。

MaximumDestinationAddress xsd:int 北向接口支持数组的最大长度。

MaximumMessageLength xsd: int 北向接口中消息内容大小的最大

AllowNotifySmsReception xsd:boolean 是否支持通知。

GetMessageSupport xsd:boolean 是否支持用get方式收彩信

GetStatusSupport xsd:boolean 是否支持用get方式收彩信状态

MultiSupport xsd:boolean 是否支持群发

MultiAllowed xsd:boolean 是否允许彩信群发

中

- 21 -

兴

公

司

专

用

值。