中国电信综合业务接入网关(ISAG)开放接口技术规范--MMS RC V1.1.0

发布时间：2024-11-17

保密等级：公开发放

中国电信综合业务接入网关（ISAG）

开放接口技术规范

MMS RC 1.1.0

中国电信集团公司发布

1范围 ......................................................................... 4 2规范引用性文件 ............................................................... 错误！未定义书签。 3缩略语 ....................................................................... 6 4服务概述 ..................................................................... 8 5序列图 ....................................................................... 9 6数据类型 ..................................................................... 10 6.1 DeliveryStatus ............................................................ 10 6.2 DeliveryInformation ....................................................... 10 6.3 MessageReference .......................................................... 10 6.4 MessageURI ................................................................ 11 6.5 MessagePriority ........................................................... 11 7接口定义 ..................................................................... 12 7.1接口：SendMessage .......................................................... 12 7.2接口：GetMessage ........................................................... 15 7.3接口：MessageNotification .................................................. 18 8差错定义 ..................................................................... 20 9服务策略 ..................................................................... 21

2 中国电信综合业务接入网关（ISAG）开放接口技术规范

前言

本系列规范由八项规范组成，名称如下：中国电信综合业务接入网关ISAG总体技术规范中国电信综合业务接入网关ISAG设备技术规范中国电信ISAG Router设备技术规范

中国电信综合业务接入网关ISAG开放接口技术规范

中国电信综合业务接入网关ISAG协议映射南向接口技术规范中国电信综合业务接入网关ISAG路由接口技术规范中国电信综合业务接入网关ISAG业务流程技术规范中国电信综合业务接入网关ISAG业务测试规范

本系统规范主要依据3GPP和OMA的有关规范和信息产业部颁布的相关行业技术标准编制。本规范解释权属于中国电信集团公司。

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

中国电信综合业务接入网关（ISAG）开放接口技术规范 3

1 范围

IT领域的第三方业务提供商可以通过综合业务接入网关访问和使用电信网络的业务能力。本规范规定了中国电信综合业务接入网关向第三方提供的电信网络业务能力，描述了这些业务能力的应用开发接口（API），用于指导综合业务接入网关的设计开发及CP/SP接口应用。

本规范适用于中国电信移动业务网络综合业务接入网关（ISAG）的设备提供商及与此相关的内容提供商、服务提供商。为综合业务接入网关设备制造、工程设计和网络运行、管理和维护等方面提供技术依据。

4 中国电信综合业务接入网关（ISAG）开放接口技术规范

2 规范性引用文件

下列文件通过本文的参考而成为本规范的条款。凡是注日期的参考文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文，凡是不注日期的参考文件，其最新版本适用于本文。 1 2 3 4

《中国电信综合业务接入网关ISAG总体技术规范》

3GPP,TS 29.198 Open Service Access (OSA); Application Programming Interface (API) ETSI ES 202 391-2

Parlay Group, Parlay 4.0 Parlay X Web Services Specification

中国电信综合业务接入网关（ISAG）开放接口技术规范 5

3 缩略语

6 中国电信综合业务接入网关（ISAG）开放接口技术规范

中国电信综合业务接入网关（ISAG）开放接口技术规范 7

4 服务概述

当前，为了接收和发送彩信，在写应用时必须使用专门的协议来接入网元（例如，彩信中心MMS-C）提供的MMS功能。这种方式要求应用开发商对网络有高度的专业知识。本章定义了一种彩信Web Service，通过使用这个MMS Web Service，应用开发商不需要专门的电信知识，就能调用彩信功能。

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

为从网络接收彩信，可使用通知机制（参见MMS Notification API）。通知机制更通用：网络发起的消息被发送到自我管理的应用侧web service。与通知相关的提供准则不在此描述。

8 中国电信综合业务接入网关（ISAG）开放接口技术规范

5 序列图

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

用户登录一个卡通图片业务门户网站，为过生日的好友选择祝福卡片，并编辑祝福短信后，点击彩信发送。图片门户与MMS服务间通过API交互完成彩信的发送。

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

图1. 彩信服务

中国电信综合业务接入网关（ISAG）开放接口技术规范 9

6 数据类型

6.1 DeliveryStatus

数据类型：枚举

6.2 DeliveryInformation

数据类型：结构

6.3 MessageReference

数据类型：结构 10 中国电信综合业务接入网关（ISAG）开放接口技术规范

6.4 MessageURI

数据类型：结构

6.5 MessagePriority

数据类型：枚举

中国电信综合业务接入网关（ISAG）开放接口技术规范 11

7 接口定义

7.1 接口：SendMessage

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

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

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

7.1.1 操作：sendMessage

业务触发条件由应用提供商与签约用户进行预先约定，由应用根据业务需要在恰当时刻调用本接口，给用户发送一条彩信。本消息调用是请求发送一条彩信到一组地址集合，并返回RequestIdentifier对本消息的发送进行标识。网关根据第三方的要求用notifyMessageDeliveryStatus 返回状态报告，并使用RequestIdentifier与先前发送的消息相关联。彩信的内容是使用MIME编码作为一个SOAP附件进行发送。第三方通过ReceiptRequest告知网关是否需要返回状态报告。

7.1.1.1

输入：sendMessageRequest

12 中国电信综合业务接入网关（ISAG）开放接口技术规范

7.1.1.2

输出：sendMessageResponse

7.1.1.3

业务异常：

差错

SVC0001 – 业务错误。 SVC0002 – 非法输入值。 SVC0004 – 非法地址。 SVC0006 – 非法组。策略异常：

POL0001 – 策略错误。 POL0006 – 组不被允许。 POL0007 – 嵌套组不被允许。 POL0008 – 不允许提交计费信息。 POL0900– 不支持群发。

中国电信综合业务接入网关（ISAG）开放接口技术规范 13

POL0907– 不允许群发。

7.1.2 操作：getMessageDeliveryStatus

7.1.2.1

输入：getMessageDeliveryStatusRequest

7.1.2.2

输出：

getMessageDeliveryStatusResponse

7.1.2.3

业务异常：

差错

SVC0001 – 业务错误。 SVC0002 – 非法输入值。策略异常：

POL0001 – 策略错误。

14 中国电信综合业务接入网关（ISAG）开放接口技术规范

7.2 接口：GetMessage

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

GetReceivedMessages：应用获取消息的参考消息。 GetMessageURIs：应用获取指定消息的URIs。 GetMessage：应用获取整条消息内容。

7.2.1 操作：getReceivedMessages

这个操作是使用一个特殊的注册标识符获得一条新的消息。如果注册标识符未被指定，Parlay X服务器将返回应用发送的所有消息的参考信息。绑定不同注册标识符参数是一个不在线的处理过程。Parlay X网关不允许使用一个未与应用关联的注册标识符获取消息。应用可设置优先参数（Priority）接收高优先级的消息，即，如果设置为普通级参数，则会返回普通级别以上的的所有消息。如果该优先级参数省略，则会返回所有的消息信息。

7.2.1.1

输入：getReceivedMessagesRequest

7.2.1.2

输出：getReceivedMessagesResponse

中国电信综合业务接入网关（ISAG）开放接口技术规范 15

7.2.1.3

业务异常：

差错

SVC0001 – 业务错误。 SVC0002 – 非法输入值。策略异常：

POL0001 – 策略错误。

7.2.2 操作：getMessageURIs

这个操作将读取消息的不同部分，在业务接入网关建立本地文件并且返回URI标识。应用可以仅仅读取每个文件或将其以链接的形式呈现给最终用户。文件的URIs将在协定的时间被激活。