【YD通讯标准】 基于表述性状态转移(REST)技术的电信业务能力开放平台技术要求

ICS33.030
中华人民共和国通信行业标准
YD/T2423-2012
基于表述性状态转移（REST）
技术的电信业务能力开放平台技术要求Requirementto REsTbased telecom serviceopen platform2012-12-28发布
2013-03-01实施
中华人民共和国工业和信息化部发布前言·
1范围
2规范性引用文件.·
3术语和定义·
4缩略语·
5开放平台概念及总体功能
6系统架构要求·
6.1基于表述性状态转移技术的电信业务能力开放架构：YD/T2423-2012
6.2基于表述性状态转移技术的电信业务能力开放平台（RESTTOP）的系统结构7业务流程要求
7.1概述·
7.2管理流程·
7.3能力调用流程
8计费和向计费系统提供的信息要求.8.1计费要求
向计费系统提供的信息要求
9网管要求
9.1管理方式
9.2网络管理的主要功能
10安全性要求
附录A（资料性附录）应用使用流程（示例）附录B（规范性附录）服务水平协议（SLA）列表·参考文献
建筑321---标准查询下载网
YD/T2423-2012
本标准是基于表述性状态转移（REST）技术的电信业务能力开放系列标准之一，该系列标准的结构及名称预计如下：
基于表述性状态转移（REST）技术的电信业务能力开放平台技术要求：基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）点击拨号业务：基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）短消息和多媒体消息业务；
基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）搜索业务：基于表述性状态转移（REST）技术的业务能力开放应用程序接口（API）微博业务。本标准按照GB/T1.1-2009给出的规则起草。本标准由中国通信标准化协会提出并归口。本标准起草单位：中国移动通信集团公司、中国联合网络通信有限公司、中兴通讯股份有限公司、工业和信息化部电信研究院
本标准主要起草人：，管晓培、王亚晨、俞承志、吴伟、刘晓靖、黄。I
YD/T2423-2012
基于表述性状态转移（REST）技术的电信业务能力开放平台技术要求
1范围
本标准规定了基于表述性状态转移（REST）技术的电信业务能力开放平台（简称RESTTOP）的总体功能需求、系统架构要求、业务流程要求、计费和话单要求、网管要求、安全性要求等，本标准适用于通过开放API技术实现IMS网络业务能力与传统电信能力向互联网开放的场景。2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。IETFRFC2617
IETFRFC5849
术语和定义
HTTP鉴权：基本和压缩的接入鉴权（HTTPAuthentication：BasicandDigestAccess Authentication)
OAuth1.o协议（TheOAuth1.oProtocol）下列术语和定义适用于本文件。表述性状态转移RepresentationalStateTransfer一种针对网络应用的设计和开发方式，指的是一组架构约束条件和原则，可以降低开发的复杂性，提高系统的可伸缩性。
基于表述性状态转移技术的电信业务能力开放平台TelecomServiceOpenPlatformBasedonREST
将电信能力封装成表述性状态转移（REST）风格的API，并对应用进行开放的电信业务能力开放平台。
Web服务WebService
一种构建应用程序的普遍模型，可以在任何支持网络通信的操作系统中实施运行：一种新的Web应用程序分支，是自包含、自描述、模块化的应用，可以发布、定位、通过Web调用。3.4
简单对象访问协议SimpleObjectAccessProtocol一种轻量、简单、基于XML的协议，它被设计成在Web上交换结构化的和固化的信息。3.5
建筑321---标准查询下载网
YD/T2423-2012
一种开放的协议，为桌面程序或Web应用提供了种简单的、标准的方式去访问需要用户授权的API服务。
Diameter
一种用于IMS网络的认证、授权、计费协议。4
缩略语
下列缩略语适用于本文件。
I-CSCF
P-CSCF
RESTTOP
S-CSCF
Application Programming InterfaceAccessToken
Business Operation Support SystemCharging Collection FunctionCalling Detail Records
Customer Resource ManagementCall SessionControlFunction
File Transfer Protocol
Home Location Register
Home Subscriber Server
Hyper Text Transfer ProtocolInterrogating-CSCF
IP Multimedia Subsystem
Mobile Location Protocol
Online Charging System
Open Mobile Alliance
Proxy-CSCF
Presence Group Instant MessageQuality of Service
Representational State TransferTelecomserviceOpenPlatformbasedonRESTRequest Token
Serving-CSCF
Session Initiation Protocol免费标准bzxz.net
Service Level Agreement
Short Message Service
Short Message Service CenterSimple Network Management ProtocolSimple Object Access Protocol应用程序编程接口
访问令牌
业务运营支撑系统
计费采集功能
呼叫详细记录
客户资源管理
呼叫会话控制功能
文件传输协议
归属域定位注册器
归属订户服务器
超文本传输协议
查询CSCF
IP多媒体子系统
移动定位协议
在线计费系统
开放移动联盟
代理CSCF
状态呈现，群组，即时消息
服务质量
表述性状态转移
基于表述性状态转移（REST）技术的电信业务能力开放平台
请求令牌
服务CSCF
会话初始化协议
服务水平协议
短消息服务
短消息中心
简单网管协议
简单对象接入协议
Security Socket Layer
WirelessApplicationProtocol
XMLConfiguration Access ProtocolExtensibleMarkupLanguage
开放平台概念及总体功能
安全套接字层
无线应用协议
XML配置访问协议
可扩展Markup语言
YD/T2423-2012
“基于表述性状态转移（REST）技术的电信业务能力开放平台（RESTTOP）”吸收与借鉴了互联网的开放模式，其具备了开放、融合的特性，能够整合通信网与互联网2种异构环境下的各类元素，将传统电信网能力通过封装形成表述性状态转移（REST）风格的API接口，对互联网进行开放。运营商可以利用RESTTOP整合异构能力的先天特性；提供一个基础通信能力开放平台，向互联网开放运营商的基础通信能力，将通信网络的网络和业务能力以适合互联网的模式向用户及其他应用开放，并将通信网络能力融入Web2.0的生态环境，从而实现通信业务与互联网业务的融合。同时，通过建立良好的商业模式吸引互联网开发者入驻，让开发者自已开发适合市场的应用。基于表述性状态转移技术的电信业务能力开放平台（RESTTOP）作为开放IMS能力与传统电信能力及互联网业务能力的网关设备，应具备如下功能：a）连接各种网络业务能力平台：南向采用各类现有标准化接口连接各网络业务能力平台，实现对于电信业务能力（包括IMS业务平台和传统电信业务平台所提供的通信能力）的调用：b）采用统一风格的API向应用开放网络业务能力：北向采用基于表述性状态转移（REST）技术的开放API，向各类应用提供统一的能力调用方法；c）应用逻辑控制：RESTTOP内部对于应用、应用所隶属的合作伙伴以及用户进行认证授权，对于应用逻辑进行通用控制；
d）服从通用管理：连接业务管理系统以及计费等系统，服从统一管理，完成网元统一功能；e）业务能力开放和聚合：将电信能力向互联网开放，同时，也可将互联网业务能力进行适配，使得电信运营商能够将互联网业务能力同电信业务能力进行整合，在RESTTOP上以统一的接口形式进行开放，通过调用电信业务能力与互联网业务能力融合产生新的业务和应用。6系统架构要求
6.1基于表述性状态转移技术的电信业务能力开放架构6.1.1RESTTOP在网络中的位置
RESTTOP作为电信业务能力开放的网关设备定位于：a）连接各种网络业务能力平台：南向采用各类标准化接口连接传统电信业务能力平台、IMS核心网及业务能力平台、互联网业务能力平台，实现对于IMS和2G/3G通信能力以及互联网业务能力的调用；b）采用REST风格的API向应用开放网络业务能力：北向采用开放API的方式向各类应用提供统一REST风格的能力调用方法：
c）应用逻辑控制：RESTTOP内部对于应用、开发者以及用户进行认证鉴权，对于应用逻辑进行通用控制：
d）服从通用管理：作为网元，连接业务管理系统以及计费、网管等系统，服从统一管理，完成网元统一功能。
建筑321---标准查询下载网
YD/T.2423-2012
RESTTOP在IMS网络的开放性基础上，整合传统电信网络和互联网的业务能力，采用REST风格API的方式向应用开放，通过灵活组合各种网络业务能力开发多样化应用的方式为用户提供多样化的业务体验。RESTTOP在网络中的位置如图1所示。Web2.0应用
用户门户
开发者门户
（相络服务）
其他开放平台
其他电信业务
超力开故平台(RESTISOAP/ETP）互联网业务能力
互联业务能力
互联网业务韵
五联网业车销
网元功能描述
信息通信技术
（ICT）应用
（满足表述性状惠转移APD
网管/计费
Dlamcter/FTP
计费系统
电信业务能力开放平台
传统电信业务能力
（码认在协议（短消应点对点（向络服务）小LP)(PA
协证(SMPP))
群组管理
业务平台
(SOAP)
(网络服务)
(SNMP)
业务管理
网管系统
wsIMS业务能力
广即时消息
业务平台
+(asc)
图1基于RESTTOP的电信业务能力开放架构6.1.2.1基于表述性状态转移（REST）技术的电信业务能力开放平台广其他应用
服务器
基于表述性状态转移（REST）技术的电信业务能力开放平台（RESTTOP）作为电信业务能力开放的核心部件，提供了一套符合互联网开发者习惯的开放API接口，它独立于开发语言、操作系统，使得开发者可以选择擅长的语言进行开发，是实现基础通信能力开放的核心设备。6.1.2.2IMS业务能力
IMS业务能力包括IMS核心网和IMS业务服务器两部分。a）IMS核心网：IMS核心网中的控制实体包括P-CSCF、S-CSCF、I-CSCF等核心网元。其中，S-CSCF通过ISC接口，使用SIP协议与RESTTOP相连，提供核心网的各种能力。b）IMS业务服务器：IMS业务服务器通过IMS核心网ISC接口与RESTTOP连接或通过自身开放接口与RESTTOP相连，包括以下几个服务器。即时消息业务服务器：IMS中实现即时消息能力的AS和实现状态呈现的业务逻辑可以根据具体需求提供标准北向接口，通过SOAP协议与RESTTOP相连，或者通过IMS核心网CSCF的ISC接口，开放其业务能力。
一群组管理业务服务器：IMS中实现群组管理能力的AS和实现群组管理的业务逻辑可以根据具体需求提供标准北向接口，通过XCAP协议与RESTTOP相连，或者通过IMS核心网CSCF的ISC接口，开放其业务能力。
YD/T2423-2012
一其他应用服务器：如会议、Centrex等IMS应用服务器，要求其均按照规范要求向RESTTOP提供标准北向接口，或者通过IMS核心网CSCF的ISC接口，开放其业务能力。6.1.2.3传统电信业务能力
传统电信业务能力主要包括短信息网关、多媒体消息网关和其他网关。a）短消息网关：传统通信网络基础短消息能力网关，具备短消息上下行、短消息状态报告查询等能力。b）多媒体消息网关：传统通信网络基础多媒体消息平台，具备多媒体消息上下行、多媒体消息状态报告查询等能力。
c）其他网关：如WAP网关、移动定位网关等，其均需按照规范要求向RESTTOP提供标准北向接口，以提供自身的业务能力。
6.1.2.4互联网业务能力
RESTTOP通过2种方式实现电信能力与互联网能力的聚合：a）互联网企业或相关组织将自身所能提供的业务能力、资源等按照规范要求进行封装，并向RESTTOP开放：
b）将互联网能力与电信网能力在应用中进行聚合，即应用通过RESTTOP调用电信业务能力，通过调用互联网企业或相关组织提供的开放API等由应用本身对电信能力与互联网能力进行聚合，产生新的业务，并提供给用户使用。
6.1.2.5网管/计费
网管/计费包括在线/离线计费系统、业务管理系统和网管系统三个部分。a）在线/离线计费系统（OCS/CCF)：在线计费服务器OCS，其对相关网元提供了在线计费功能。离线计费网关CCF，通过Diameter协议从RESTTOP以及业务平台收集用户话单，进行一系列合并、整理后生成CDR并发送给业务管理系统，完成后计费功能。b）业务管理系统：主要功能包括发布业务、为用户/第三方合作伙伴开户、销户等，并将相关管理信息同步到RESTTOP。
c）网管系统：网管服务器为RESTTOP提供网元管理能力，主要是提供各网元的配置拓扑信息、告警、性能数据、日志、维测、统计等功能。6.1.2.6门户
门户包括用户门户、开发门户2种。一用户门户。用户门户为用户提供如下功能a）用户管理；
b）用户能力订购管理：
c）用户与应用的订购管理：
d）用户的文档、论坛、博客等支撑功能（可选）。开发者门户。开发者门户包括开发者管理、开放能力展示订购功能、技术资料发布展示功能、应用创建发布功能、论坛、博客等支撑系统。为开发者提供如下功能：a）开发者管理；
b）开发者能力订购管理；
c）开发者开发出的应用管理；
建筑321---标准查询下载网
YD/T2423-2012
d）应用测试与运行空间：
e）开发者开发过程的相关文档与软件、论坛、博客等支撑功能（部分可与用户对应功能合设）（可选）。6.1.2.7上层应用
上层应用包括Web2.0和信息通信技术（ICT）应用：a）Web2.0应用：运行过程存在对RESTTOP开放API调用的互联网应用；b）ICT应用：存在RESTTOPAPI调用的IT类应用。6.1.2.8其他电信业务能力开放平台RESTTOP应具备分级部署的能力，运营商可依据规划，如果需要进行全网和省级分级应用的开展或处于其他运维方面的需求，电信业务能力开放平台的业务平台可采用二级部署模型，即除了在全国统一部署一个一级业务平台外，各省可分别部署相应省的二级业务平台。一级业务平台与全部的二级业务平台互连，如图2所示。
RESTTOP二级组网
一鞍人
务商力
二级平台
一级平台
业各的力
Cr应用
子物邦
二级平台
图2RESTTOP两级部器模型
一级平台、二级平台具体实现功能如下。a业务
二级平台
a）一级平台：为全国级业务平台，完成全国级应用的订购、接入以及日常管理，支持一级业务平台能力开放，提供全国统一开发门户，提供统一业务生成和运行环境。b）二级平台：为省级业务平台，负责省级业务的开通、接入以及日常管理，完成本省/大区业务平台能力开放，提供省级/大区级业务执行环境：负责路由到本省的全国级应用请求的处理。路由字段支持：下行消息支持手机号段或者IMS域路由，上行消息或互通类消息支持应用ID路由。6.1.3接口描述
6.1.3.1概述
YD/T24232012
各网元与基于表述性状态转移（REST）技术的电信业务能力开放平台的接口关系如下。6.1.3.2B1-计费系统
RESTTOP与计费系统之间的接口遵循Diameter/FTP协议。6.1.3.3B2-业务管理系统
RESTTOP与业务管理系统之间的接口是基于WebService的，其主要功能包括发布业务、为用户/第三方合作伙伴开户、销户等，并将相关管理信息同步到RESTTOP。6.1.3.4B3-网管系统
RESTTOP与业务网管之间的接口是基于SNMP协议的，其主要功能是通过业务网管对RESTTOP进行维护、配置与管理。网管系统还用来检测RESTTOP类应用的告警和日志。6.1.3.5A1-应用
RESTTOP业务能力开放应用程序接口（API）包括：基于REST方式实现的REST风格API、支持点击拨号业务API、短消息和多媒体消息业务API、微博业务API、搜索业务API。6.1.3.6A2-开发者门户/用户门户RESTTOP与开发者门户、用户门户之间的接口采用基于WebService或REST风格API均可。6.1.3.7C1-CSCF
RESTTOP通过SIP协议与CSCF连接（ISC接口），以接入IMS网络。6.1.3.8E1-WAP网关
RESTTOP通过PAP协议与WAP网关连接。6.1.3.9E2/E3-短消息网关/多媒体消息网关RESTTOP通过各类标准协议与短消息网关和多媒体消息网关连接，实现对现有短消息、多媒体消息能力的调用。
W1-群组管理业务平台
根据具体需求，RESTTOP通过XCAP协议或者IMS核心网CSCF的ISC接口与群组管理业务平台连接。6.1.3.11W2-即时消息业务平台
根据具体需求，RESTTOP通过SOAP协议或者IMS核心网CSCF的ISC接口与即时消息业务平台连接。6.1.3.12E4-移动定位网关
RESTTOP通过MLP协议与移动定位网关连接。6.1.3.131-互联网业务平台
RESTTOP对互联网各业务平台提供开放接口，互联网企业或相关组织将自身所能提供的业务能力、资源等按照规范要求进行封装，通过该接口向RESTTOP开放。6.1.3.14F-其他电信业务能力开放平台一级与二级RESTTOP通过F接口进行交互。F接口具体分为F1、F2、F3接口：a）F1接口：业务执行交互接口，接口形式为REST风格的API。一级平台下发的业务请求通过该接口路由至相应省的二级平台：
b）F2接口：配置开通同步接口，接口形式为WebService形式的SOAP接口。将一级平台中的开发者、应用和用户信息同步至二级平台：7
建筑321---标准查询下载网
YD/T2423-2012
c）F3接口：采用FTP协议。二级平台将统计报表上传至一级平台。6.2基于表述性状态转移技术的电信业务能力开放平台（RESTTOP）的系统结构RESTTOP系统结构如图3所示，
Webao应
业务能力适配
短清喜网关
韩体消宝#
20/30网年
ICT应用
定在用关
业务生成/运行
婚力管理
计质功能锻计
人控制棋块
雅权桃
路电处理操#
配宝管趣视点
配计报表模块
即时滑息
图3RESTTOP系统结构
务能书
上费系
网管系统理
基于表述性状态转移（REST）技术的电信业务能力开放平台（RESTTOP）是将电信业务能力和互联网业务能力进行整合并向开发者提供的网关，其内部应具备如下功能模块。a）业务生成/运行环境
一业务生成环境：业务创建、测试，方便业务快速接入，快速有效地创建丰富、高质量和个性化的业务：
业务运行环境：对业务进行灵活地配置部署，加强运行监测机制，实现统一管理。b）统一接入
一接入模块：接受开放API请求，使得北向的应用可以以各种Web形式调用业务能力：一认证模块：对调用开放API的应用以及用户和开发者进行认证。支持HTTP基本认证（见7.2.2.2节的HTTP基本认证）方式和OAuth认证（见7.2.2.3节的OAuth认证）方式。C）通用管理
-应用管理：对开发者开发的应用进行统一管理；一能力管理：对于能力提供平台提供的能力进行统一管理：一鉴权模块：实现对业务提供商或用户已签约SLA的执行以及相关API调用权限的鉴权；一计费功能模块：提供计费功能并和计费系统相连，产生符合规定的计费消息或话单：-SLA控制模块：实现SLA控制以保证业务提供商或用户已签约的QoS，并保护系统一路由处理模块：实现网络侧业务使能之间的路由机制：8
YD/T2423-2012
统计报表模块：收集各种商业对象，例如业务能力、业务提供商、应用等的统计信息，并输出成定制报表；
-网管模块：提供给运营商网管系统的SNMIP接口，实现网管系统对平台进行维护、配置与管理：配置管理模块：通过Web服务接口和业务管理系统相连，实现业务能力、业务提供商、开发者、应用和用户等数据的配置：
一日志模块：收集系统日志并对日志进行统一管理。d）业务能力适配模块：实现与南向各类业务使能引擎的集成，包括以下几个：短消息模块：实现短消息API到短消息网关的协议转换：多媒体消息模块：实现多媒体消息API到多媒体消息网关的协议转换：点击拨号模块：实现点击拨号业务的协议转换：-其他业务能力适配模块：实现RESTTOP到上述业务以外业务能力的协议转换。业务流程要求
在RESTTOP相关的业务流程中引入如下角色：a）开发者：使用RESTTOP提供的API进行应用开发的人或组织；b）应用：运行过程调用RESTTOP提供的API应用程序：c）用户：使用应用的人或组织，业务能力的最终消费者：d）门户：开发者门户与用户门户的统称；e）管理员：系统的管理者，RESTTOP相关的关键业务流程应通过管理员审批后生效f）业务提供者：其他业务能力的提供者（如互联网服务提供商等）向RESTTOP提供互联网业务能7.2管理流程
7.2.1开发者流程
：7.2.1.1开发者注册流程
开发者
1.申精成为正式开发者，完成用户身份信息RESTTOP
2.提交用户注册申请
管理员
.保存信息
5.反馈结果
6.反馈结果
图4开发者注册流程
开发者注册流程如图4所示，流程描述如下：建筑321---标准查询下载网
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。