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

中国电信综合业务接入网关（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《中国电信综合业务接入网关ISAG总体技术规范》

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

3ETSI ES 202 391-2

4Parlay 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 数据类型：枚举

7接口定义

7.1 接口：SendMessage

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

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

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

7.1.1 操作：sendMessage

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

7.1.1.1 输入：sendMessageRequest