中國電信綜合業務接入網關_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 -

興

公

司

專

用

值。