YD/T 2305-2011
基本信息
标准号： YD/T 2305-2011
中文名称：统一通信中即时通信及语音通信相关接口技术要求
标准类别：通信行业标准(YD)
标准状态：现行
出版语种：简体中文
下载格式：.zip .pdf
下载大小：8483758
标准分类号
关联标准
出版信息
相关单位信息
标准简介
YD/T 2305-2011.Technical requirement for interfaces of instant communication and voice communication for unified communications.
1范围
YD/T 2305规定了统一通信中即时通信、语音通信业务的开放接口技术要求，包括接口的消息流程、消息的格式、参数。本标准里的即时通信范围包括即时消息(IM) 和状态呈现(Presence)。
YD/T 2305适用于统一通信系统中即时通信及语音通信功能的对外接口。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
YD/T 1522.1-2010会话初始协议技术要求第1部分:基本的会话初始协议
YD/T 1522.4-2009会话初始协议(SIP)技术要求第4部分:基于软交换网络呼叫控制的SIP协议
YD/T 1522.5-2010会话初始协议(SIP)技术要求第5部分:统一IMS网络的SIP协议
YD/T 1802-2008基于IP多媒体子系统(IMS)的呈现(Presence)业务技术要求(第一阶段)
YD/T 2014-2009统一通信业务需求
YD/T 2179-2010基于IMS的SIMPLE即时消息业务技术要求
IETF RFC4825XML(扩展标记语言)配置接入协议(XCAP)
3术语、定义和缩略语
3.1术语和定义
下列术语适用于本文件。
第三方应用Third party Application
指统一通信系统以外的其他系统所提供的应用。第三方应用可以通过开放的接口调用统-通信系统的能力，例如三方呼叫的能力。
1范围
YD/T 2305规定了统一通信中即时通信、语音通信业务的开放接口技术要求，包括接口的消息流程、消息的格式、参数。本标准里的即时通信范围包括即时消息(IM) 和状态呈现(Presence)。
YD/T 2305适用于统一通信系统中即时通信及语音通信功能的对外接口。
2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。
YD/T 1522.1-2010会话初始协议技术要求第1部分:基本的会话初始协议
YD/T 1522.4-2009会话初始协议(SIP)技术要求第4部分:基于软交换网络呼叫控制的SIP协议
YD/T 1522.5-2010会话初始协议(SIP)技术要求第5部分:统一IMS网络的SIP协议
YD/T 1802-2008基于IP多媒体子系统(IMS)的呈现(Presence)业务技术要求(第一阶段)
YD/T 2014-2009统一通信业务需求
YD/T 2179-2010基于IMS的SIMPLE即时消息业务技术要求
IETF RFC4825XML(扩展标记语言)配置接入协议(XCAP)
3术语、定义和缩略语
3.1术语和定义
下列术语适用于本文件。
第三方应用Third party Application
指统一通信系统以外的其他系统所提供的应用。第三方应用可以通过开放的接口调用统-通信系统的能力，例如三方呼叫的能力。
标准图片预览
标准内容
ICS33.030
中华人民共和国通信行业标准
YD/T2305-2011
统一通信中即时通信及语音通信相关接口技术要求
Technical requirement for interfaces of instant communication andvoicecommunicationforunifiedcommunications2011-12-10发布
2011-12-10实施
中华人民共和国工业和信息化部发布前言
1范围
2规范性引用文件：
3术语、定义和缩略语…·
3.1术语和定义·
3.2缩略语·
4开放接口的功能模型和接口
整体功能模型·
C接口
C接口
C接口·
C4接口
4.6接口
4.7I2接口
4.8I接口·
4.94接口-
4.10Is接口.
5C接口
5.1C接口的功能·
5.2SIPMessage消息头+XML消息体-5.3XCAP...
6C4接口
6.1WebServices消息结构
6.2数据类型
6.3公共异常定义
7I接口
附录A（资料性附录）C,接口的XML消息体编码格式附录B（资料性附录）C接口的Schema'建筑321--标准查询下载网
YD/T2305-2011
YD/T2305-2011
本标准按照GB1.1-2009给出的规则起草。本标准是统一通信系列标准之一，该系列标准的结构及名称预计如下：一统一通信业务需求：
统一通信中即时通信及语音通信相关接口技术要求。随着需求和技术的发展，还将制定后续的相关标准。本标准由中国通信标准化协会提出并归口。本标准起草单位：中国电信集团公司、中国移动通信集团公司、工业和信息化部电信研究院、中兴通讯股份有限公司、新太科技股份有限公司、华为技术有限公司。本标准主要起草人：聂衡、江志峰、王明德、黄、李健、刘景磊、田之进、畅务昕。
1范围
YD/T2305-2011
统一通信中即时通信及语音通信相关接口技术要求本标准规定了统一通信中即时通信、语音通信业务的开放接口技术要求，包括接口的消息流程、消息的格式、参数。本标准里的即时通信范围包括即时消息（IM）和状态呈现（Presence）。本标准适用于统一通信系统中即时通信及语音通信功能的对外接口。2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。YD/T1522.1-2010
YD/T1522.4-2009
YD/T1522.5-2010
YD/T1802-2008
YD/T2014-2009
YD/T2179-2010
IETFRFC4825
会话初始协议技术要求第1部分：基本的会话初始协议会话初始协议（SIP）技术要求第4部分：基于软交换网络呼叫控制的SIP协议会话初始协议（SIP）技术要求第5部分：统一IMS网络的SIP协议基于IP多媒体子系统（IMS）的呈现（Presence）业务技术要求（第一阶段）统一通信业务需求
基于IMS的SIMPLE即时消息业务技术要求XML（扩展标记语言）配置接入协议（XCAP）3术语、定义和缩略语
3.1术语和定义
下列术语适用于本文件。
第三方应用ThirdpartyApplication指统一通信系统以外的其他系统所提供的应用。第三方应用可以通过开放的接口调用统一通信系统的能力，例如三方呼叫的能力。3.2缩略语
下列缩略语适用于本文件。
Application UniqueID
Hyper Text Transfer ProtocolInstant Message
Open Mobile Alliance
Session Initiation Protocol
Unified Communications
Unified Communications EndpointXMLConfigurationAccess ProtocolExtensible Markup Language
XCAP User Identifier
建筑321---标准查询下载网
应用唯一标识
超文本传输协议
即时消息
开放移动联盟
会话初始协议
统一通信
统一通信客户端
XML配置访问协议
可扩展标记语言
XCAP用户标识
YD/T2305-2011
4开放接口的功能模型和接口
4.1整体功能模型
根据YD/T2014-2009的业务功能要求，统一通信中即时通信和语音通信的接口模型如图1所示。第三方应用
业务网关
统一通信
客户端
统一通信
业务系统
语音通信
即时通信
图1即时通信和语音通信的接口模型4.2C接口
语音通信
即时通信
本接口为统一通信语音功能与统一通信客户端之间的接口。通过开放本接口，统一通信的语音通信功能可以对客户端提供语音增值业务。支持的功能如下：a）支持客户端通过点击通讯录、通话历史记录或输入被叫地址采用点击呼叫方式发起呼叫。b）支持向客户端实时显示呼叫进展状态，如接续中、通话中等。c）支持呼叫控制，允许客户端对呼叫进行拒绝、转移、保持、挂断等操作。d）支持客户端预先设置呼叫终端，预先设置的终端可以作为发话时用户通话终端。e）支持客户端预先设置来话时用户的同振或者顺振终端（2~3个），具体的呼叫控制策略可以由客卢端设置。
本接口采用SIP+XML、XCAP，具体接口要求见第5章。4.3C2接口
本接口为统一通信的语音通信功能与公网的语音通信互通接口，本接口采用SIP协议与公网互通，具体接口见YD/T1522.4和YD/T1522.5，本标准不做具体要求。4.4C3接口
本接口为统一一通信的语音通信与业务网关之间的接口，属于系统的内部接口，在本标准中不做具体要求。
4.5C4接口
本接口为统一通信的语音通信、即时通信能力开放给第三方应用的接口，通过业务网关实现开放。通过开放本接口，统一通信的语音通信功能、即时通信功能可以向第三方应用开放能力。本标准规定了开放语音通信功能里的第三方呼叫能力，对于其他能力的开放不做具体要求。C4接口支持如下功能：a）支持向外部应用提供点击拨号功能，外部应用可以在接口中指定主叫号码、被叫号码发起呼叫。b）支持在呼叫过程中向外部应用实时返回呼叫进行的状态和结果，包括“正在接续主叫”、“正在接续被叫”、“主叫振铃”、“被叫振铃”、“主叫忙”、“被叫忙”、“被叫无人接听”、“被叫不可达”、“通话已建立”等。
本接口采用WebServices方式，具体接口要求见第6章。4.61接口
YD/T2305-2011
本接口为统一通信即时通信功能与统一通信客户端之间的接口。即时通信功能通过该接口向客户端提供即时消息、状态呈现服务，在本标准中不做具体要求。4.712接口
本接口为统一通信即时通信功能中的呈现功能与公网即时通信的呈现功能的互通接口。支持的功能如下：
a）支持订阅其他用户状态的操作的互通。b）支持查询其他用户呈现状的操作的互通。c）支持被订阅者状态改变时的更新通知的互通。本接口采用Presence业务的SIP协议。具体接口见YD/T1802-2008的参考点IP-1，在本标准中不做具体要求。
4.813接口
本接口为统一通信即时通信功能中的即时消息功能与公网即时通信的即时消息功能的互通接口。支持的功能如下：
a）支持点到点即时消息、点到多点的群发消息、离线消息、定时消息的互通。b）支持消息发送回执的互通。
c）支持临时群组消息的互通。
本接口采用IM业务的SIP协议。具体接口见YD/T2179-2010的参考点IP-1，在本标准里不做具体要求。
4.914接口
本接口为统一通信的即时通信与业务网关之间的接口，属于系统的内部接口，在本标准中不做具体要求。
4.1015接口wwW.bzxz.Net
本接口为统一通信的即时通信功能与语音通信功能之间的接口，通过开放本接口，语音通信功能可以与即时通信功能进行集成，对用户的呈现状态进行订阅和发布。支持的功能如下：a）支持语音业务功能根据用户的通话状态发布用户的状态信息。b）支持语音业务功能查询用户的呈现状态信息。提供查询权限管理机制，支持根据语音业务功能的权限限定其所能查询的范围。查询可以通过订阅来实现。c）支持语音业务功能订阅用户的状态信息，并在用户状态改变时将用户的最新状态通知语音业务功能。这样语音业务功能可以根据用户当前的呈现状态进行来话管理。本接口采用SIP方式，具体接口要求见第7章。5C接口
5.1C1接口的功能
语音通信功能与客户端UE之间的C，接口采用SIPMessage消息以及XCAP协议。其中SIPMessage消息携带XML消息体实现预设电话、点击呼叫、实时显示呼叫进展状态、呼叫过程中的用户控制：XCAP协议实现预先设置来话时用户的同振顺振号码、设置通信规则和呼叫路由策略。建筑321---标准查询下载网
YD/T2305-2011
5.2SIPMessage消息头+XML消息体5.2.1SIP消息通信
SIP消息通信为交互方式，根据具体业务操作的不同，消息既可以由客户端UE发起，也可以由语音通信功能发起。
客户端UE发起的SIP消息涉及到的业务操作，包括预设请求、点击呼叫请求、挂断成员请求、结束呼叫请求、拒绝接听、应答接听、应答转移、呼叫保持请求、呼叫恢复请求。流程如图2所示。UE
1.Message
语音通信功能
图2客户端UE发起的SIP消息流程语音通信功能发起的SIP消息涉及到的操作，包括预设响应、点击呼叫响应、点击呼叫状态、挂断成员响应、结束呼叫响应、新呼叫通知、呼叫保持响应、呼叫恢复响应。流程如图3所示。UE
语音通信功能
图3语音通信AS发起的SIP消息流程5.2.2消息体
5.2.2.1消息体内容
消息体包含XML文本，其中包含Action等命令参数，请求对方进行某些控制操作，例如预设电话、点击呼叫、来电接听、呼叫转接、呼叫保持等。5.2.2.2预设电话
通过预设电话，UE可以对其语音通话的拨打和接听终端进行设置，语音终端可设置的范围为工作电话、移动终端、电脑、或临时输入的其他电话号码。预设电话的XML消息体编码格式见附录A。5.2.2.3点击呼叫
通过点击呼叫，UE可以点击通讯录、通话历史记录或输入被叫地址等发起呼叫，并且可以得到呼叫进展状态。
点击呼叫的XML消息体编码格式见附录A。5.2.2.4来电接听与转移
通过来电接听与转移，当UE在线时，如果其业务号码有来电（主叫为B），UE将提示用户进行处理，处理方式可以包括接听、拒绝、转接三种。来电接听与转移的XML消息提编码格式见附录A。5.2.2.5呼叫保持与恢复
通过呼叫保持与恢复操作，UE可以保持预设电话与远端的通话，此时远端将听到等待音。针对处于保持状态的通话，UE可以将其恢复。此时预设电话与远端恢复正常通话。4
呼叫保持与恢复的XML消息提编码格式见附录A。5.3XCAP
5.3.1XCAP协议
YD/T2305-2011
通过XCAP协议，可以实现设置用户的第一终端、第二终端，并设置用户自已的通信规则。语音业务根据通信规则、设置的终端以及用户的在线状态，进行相应的共振、顺振处理。XCAP协议具体内容见IETFRFC4825。
5.3.2设置终端
5.3.2.1流程
设置用户第一、第二终端的XCAP流程如图4所示。UE
语音通信功能
。修改用户个人信息
2.未认证
3。嫌改用户个人信息（带认证）4.修改成功
图4设置用户终端流程
流程说明：
1）客户端UE发起修改用户个人信息的请求给语音通信功能，要求修改一个用户的个人信息。个人信息中包括了需要设置/修改的第一终端和第二终端。2）由于客户端UE首次发起的修改用户个人信息的请求，其中没有包含认证信息，语音通信功能需要对该客户端进行鉴权，并返回客户端尚未认证的信息。3）客户端UE再次发起修改用户个人信息的请求给语音通信功能，这次请求中包含了认证信息。4）语音通信功能进行必要的认证和个人信息变更后，返回客户端修改成功的信息，表示修改成功。5.3.2.2参数和Schema
HTTP方法：PUT
消息体的Schema：com：ctc:ims-pim，具体格式参见附录B。5.3.3设置通信规则
5.3.3.1流程
设置通信规则的XCAP流程如图5所示。UE
语音通信功能
1.修改用户通信规则
2.未认证
3.修改用户通信规则（带认证）4.修改成功
图5通信规则修改流程
建筑321---标准查询下载网
jz32L.net
YD/T2305-2011
流程说明：
1）客户端UE发起修改用户通信规则的请求给语音通信功能，要求修改一个用户的通信规则。该请求中包括了需要修改的用户通信规则：2）由于客户端UE首次发起的修改用户通信规则的请求，其中没有包含认证的信息，语音通信功能需要对该客户端进行认证，并返回客户端尚未认证的信息。3）客户端UE再次发起修改用户通信规则的请求给语音通信功能，这次请求中包含了认证信息。4）语音通信功能进行必要的认证和通信规则信息变更后，返回客户端修改成功的信息，表示修改成功。
5.3.3.2参数和Schema
HTTP方法：PUT
消息体的Schema：com：ctccomrule，具体格式参见附录B。6C4接口
6.1WebServices消息结构
6.1.1总体结构描述
C4接口采用WebServices方式。每一个消息交互过程都有一个请求（request）和一个响应（response）收到请求后，接收方需要立即响应。由于应用需要获得呼叫的状态，业务网关通过NOTIFY方式通知应用当前的呼叫状态，此时接口的实现者为第三方应用，具体见6.1.3.6节。考虑到实现的难度，本标准也提供了第三方应用获取呼叫的状态接口，此时的接口实现者仍为业务网关，该接口实时性和效率相对较低，具体见6.1.3.7节。WebService接口的格式统一如下：6.1.1.1请求（request)
消息部分
RequestHeader
RequestBody
6.1.1.2响应（response）
消息部分
ResponseHeader
ResponseBody
6.1.2消息头结构
6.1.2.1标示定义
请求消息头
消息内容
请求消息体，可选字段，见具体消息的描述消息内容
相应消息头
请求消息体，可选字段，见具体消息的描述消息头中包含RequestID、ServiceKey、SPID、SERVICEID、TimeStamp、HashCode等标识，其定义如下：
a）RequestID定义
消息流水号，用于匹配一对请求消息和响应消息。在发起请求消息时，发起方生成流水号，并填充在请求消息中：接收方收到请求后，在响应消息填入该流水号。为了保证消息流水的全局唯一性和实现简单性，建议使用UUID。
b）ServiceKey定义数据类型为枚举型，定义如下。5
ServiceError
THIRDPARTYCALL.bindCallingPartyRequestTHIRDPARTYCALL.bindCallingPartyResponseTHIRDPARTYCALL.makeCallRequestTHIRDPARTYCALL.makeCallResponseTHIRDPARTYCALL.notifyCallInformationRequestTHIRDPARTYCALL.notifyCalInformationResponseTHIRDPARTYCALL.GetCallInformationRequestTHIRDPARTYCALL.GetCallInformationResponsec）TimeStamp定义
业务异常
预设请求
预设回复
发起呼叫请求
发起呼叫回复
呼叫状态通知请求
呼叫状态通知回复
获取呼叫状态请求
获取呼叫状态响应
YD/T2305-2011
时间戳，用于防止重复攻击。格式为YYYYMIMDDHH24MISS的14位时间字符串。d）HashCode定义
Hash码，用于防止消息篡改攻击。接口描述的接口请求和应答的消息中，对于请求和应答中对传递的信息进行Hash运算（MD5算法），形成HashCode，用于标志请求和应答信息没有被篡改过。HashCode的生成方法HashCode=HA（SPID+key+TimeStamp），其中，加号“+”表示字符串的连接，连接后的字符串并不包括加号：Key是分配给SP的密钥，在SP和接入网关间共享。进行MD5运算时需要把字符串以UTF-8编码方式转化为byte数组后再运算。6.1.2.2下行接口消息头定义
型可选
RequestID
ServiceKey
SERVICEID
TimeStamp
HashCode
xsd:string
xsd:string
xsd:string
xsd:string
xsd:string
xsd:string
6.1.2.3上行接口消息头定义
RequestID
ServiceKey
SERVICEID
TimeStamp
HashCode
xsd:string
xsd:string
xsd:string
xsd:string
xsd:string
xsd:string
请求流水号
命令或响应类型
SP标识
SP提供的业务ID，是业务规格的唯一标识时间戳，防止重复攻击
Hash码，防止消息算改攻击
请求流水号
命令或响应类型
SP标识
SP提供的业务ID，是业务规格的唯一标识时间戳，防止重复攻击
Hash码，防止消息篡改攻击
建筑321---标准查询下载网
jz32i.net
YD/T2305-2011
6.1.3第三方呼叫（THIRDPARTYCALL）消息体结构6.1.3.1功能简述
第三方呼叫业务能力引擎在接口中可以指定主叫号码、被叫号码发起呼叫。在呼叫发起过程中，可以通过接口实时返回呼叫进行的状态和结果，包括：“呼叫正在接续”、“通话已建立”、“呼叫已经结束”、“呼叫失败”及呼叫失败原因等。6.1.3.2序列图
第三方呼叫是一个应用，通过应用提供的操作界面，在两个电话间发起呼叫。图6展示了一个基本呼叫的建立和结束以及呼叫状态通知。6.1.3.3公用数据结构定义
6.1.3.3.1calllnformation
含义：呼叫类型信息
数据类型为结构，定义如下：
CallStatus
StartTime
Duration
TerminationCause
CallStatus
DateTime
Integer
CallTerminationCause
6.1.3.3.2 callStatus
含义：呼叫状态
数据类型为枚举，定义如下：
CalInitial
CallConnected
CallTerminated
6.1.3.3.3callTerminationCause含义：呼叫结束原因
数据类型为枚举，定义如下：
CallingPartyNoAns wer
CalledPartyNoAnswer
CallingPartyBusy
CalledPartyBusy
CallingPartyNotReachable
CalledPartyNotReachable
CallHangUp
CallAborted
呼叫当前状态
呼叫开始的时间[当（caliStatusCalllnitial）时]呼叫时长（秒）
呼叫结束的原因
呼叫正在发起
呼叫已建立
呼叫已结束
主叫无应答
被叫无应答
主叫忙
被叫忙
主叫不可达
被叫不可达
任意一方挂机导致呼叫结束
呼叫终止（其他的任何原因）
应用发起呼叫
未接通前可以取消呼叫
makeCallRequest
makeCallResponse
业务网关+
语音通信功能
notifyCallnformationRequest
notifyCalllnformationResponscancelCallRequest
cancelCaliResponse
notifyCalllnformationRequestnotifyCallnformationResponse通话中
endCallRequest
endCallResponse
notifyCallinformationRequestnotifyCallnformationResponse图6第三方呼叫序列图
6.1.3.4预设（bindCallingParty）接口描述6.1.3.4.1bindCallingParty操作说明呼叫主叫
主叫挂机
挂机应答
呼叫被叫
主被叫挂机
挂机应答
第三方通过bindCallingParty指示语音通信平台预设用户接听号码。接口名称
接口描述
请求ServiceKey
应答ServiceKey
接口标识
发起呼叫接口
BindCallingParty
THIRDPARTYCALL.bindCallingPartyRequestTHIRDPARTYCALL.bindCallingPartyResponseBindCallingParty
建筑321---标准查询下载网
jz32i.net
YD/T2305-2011
振铃、接通
振铃、接通
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。
中华人民共和国通信行业标准
YD/T2305-2011
统一通信中即时通信及语音通信相关接口技术要求
Technical requirement for interfaces of instant communication andvoicecommunicationforunifiedcommunications2011-12-10发布
2011-12-10实施
中华人民共和国工业和信息化部发布前言
1范围
2规范性引用文件：
3术语、定义和缩略语…·
3.1术语和定义·
3.2缩略语·
4开放接口的功能模型和接口
整体功能模型·
C接口
C接口
C接口·
C4接口
4.6接口
4.7I2接口
4.8I接口·
4.94接口-
4.10Is接口.
5C接口
5.1C接口的功能·
5.2SIPMessage消息头+XML消息体-5.3XCAP...
6C4接口
6.1WebServices消息结构
6.2数据类型
6.3公共异常定义
7I接口
附录A（资料性附录）C,接口的XML消息体编码格式附录B（资料性附录）C接口的Schema'建筑321--标准查询下载网
YD/T2305-2011
YD/T2305-2011
本标准按照GB1.1-2009给出的规则起草。本标准是统一通信系列标准之一，该系列标准的结构及名称预计如下：一统一通信业务需求：
统一通信中即时通信及语音通信相关接口技术要求。随着需求和技术的发展，还将制定后续的相关标准。本标准由中国通信标准化协会提出并归口。本标准起草单位：中国电信集团公司、中国移动通信集团公司、工业和信息化部电信研究院、中兴通讯股份有限公司、新太科技股份有限公司、华为技术有限公司。本标准主要起草人：聂衡、江志峰、王明德、黄、李健、刘景磊、田之进、畅务昕。
1范围
YD/T2305-2011
统一通信中即时通信及语音通信相关接口技术要求本标准规定了统一通信中即时通信、语音通信业务的开放接口技术要求，包括接口的消息流程、消息的格式、参数。本标准里的即时通信范围包括即时消息（IM）和状态呈现（Presence）。本标准适用于统一通信系统中即时通信及语音通信功能的对外接口。2规范性引用文件
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅所注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。YD/T1522.1-2010
YD/T1522.4-2009
YD/T1522.5-2010
YD/T1802-2008
YD/T2014-2009
YD/T2179-2010
IETFRFC4825
会话初始协议技术要求第1部分：基本的会话初始协议会话初始协议（SIP）技术要求第4部分：基于软交换网络呼叫控制的SIP协议会话初始协议（SIP）技术要求第5部分：统一IMS网络的SIP协议基于IP多媒体子系统（IMS）的呈现（Presence）业务技术要求（第一阶段）统一通信业务需求
基于IMS的SIMPLE即时消息业务技术要求XML（扩展标记语言）配置接入协议（XCAP）3术语、定义和缩略语
3.1术语和定义
下列术语适用于本文件。
第三方应用ThirdpartyApplication指统一通信系统以外的其他系统所提供的应用。第三方应用可以通过开放的接口调用统一通信系统的能力，例如三方呼叫的能力。3.2缩略语
下列缩略语适用于本文件。
Application UniqueID
Hyper Text Transfer ProtocolInstant Message
Open Mobile Alliance
Session Initiation Protocol
Unified Communications
Unified Communications EndpointXMLConfigurationAccess ProtocolExtensible Markup Language
XCAP User Identifier
建筑321---标准查询下载网
应用唯一标识
超文本传输协议
即时消息
开放移动联盟
会话初始协议
统一通信
统一通信客户端
XML配置访问协议
可扩展标记语言
XCAP用户标识
YD/T2305-2011
4开放接口的功能模型和接口
4.1整体功能模型
根据YD/T2014-2009的业务功能要求，统一通信中即时通信和语音通信的接口模型如图1所示。第三方应用
业务网关
统一通信
客户端
统一通信
业务系统
语音通信
即时通信
图1即时通信和语音通信的接口模型4.2C接口
语音通信
即时通信
本接口为统一通信语音功能与统一通信客户端之间的接口。通过开放本接口，统一通信的语音通信功能可以对客户端提供语音增值业务。支持的功能如下：a）支持客户端通过点击通讯录、通话历史记录或输入被叫地址采用点击呼叫方式发起呼叫。b）支持向客户端实时显示呼叫进展状态，如接续中、通话中等。c）支持呼叫控制，允许客户端对呼叫进行拒绝、转移、保持、挂断等操作。d）支持客户端预先设置呼叫终端，预先设置的终端可以作为发话时用户通话终端。e）支持客户端预先设置来话时用户的同振或者顺振终端（2~3个），具体的呼叫控制策略可以由客卢端设置。
本接口采用SIP+XML、XCAP，具体接口要求见第5章。4.3C2接口
本接口为统一通信的语音通信功能与公网的语音通信互通接口，本接口采用SIP协议与公网互通，具体接口见YD/T1522.4和YD/T1522.5，本标准不做具体要求。4.4C3接口
本接口为统一一通信的语音通信与业务网关之间的接口，属于系统的内部接口，在本标准中不做具体要求。
4.5C4接口
本接口为统一通信的语音通信、即时通信能力开放给第三方应用的接口，通过业务网关实现开放。通过开放本接口，统一通信的语音通信功能、即时通信功能可以向第三方应用开放能力。本标准规定了开放语音通信功能里的第三方呼叫能力，对于其他能力的开放不做具体要求。C4接口支持如下功能：a）支持向外部应用提供点击拨号功能，外部应用可以在接口中指定主叫号码、被叫号码发起呼叫。b）支持在呼叫过程中向外部应用实时返回呼叫进行的状态和结果，包括“正在接续主叫”、“正在接续被叫”、“主叫振铃”、“被叫振铃”、“主叫忙”、“被叫忙”、“被叫无人接听”、“被叫不可达”、“通话已建立”等。
本接口采用WebServices方式，具体接口要求见第6章。4.61接口
YD/T2305-2011
本接口为统一通信即时通信功能与统一通信客户端之间的接口。即时通信功能通过该接口向客户端提供即时消息、状态呈现服务，在本标准中不做具体要求。4.712接口
本接口为统一通信即时通信功能中的呈现功能与公网即时通信的呈现功能的互通接口。支持的功能如下：
a）支持订阅其他用户状态的操作的互通。b）支持查询其他用户呈现状的操作的互通。c）支持被订阅者状态改变时的更新通知的互通。本接口采用Presence业务的SIP协议。具体接口见YD/T1802-2008的参考点IP-1，在本标准中不做具体要求。
4.813接口
本接口为统一通信即时通信功能中的即时消息功能与公网即时通信的即时消息功能的互通接口。支持的功能如下：
a）支持点到点即时消息、点到多点的群发消息、离线消息、定时消息的互通。b）支持消息发送回执的互通。
c）支持临时群组消息的互通。
本接口采用IM业务的SIP协议。具体接口见YD/T2179-2010的参考点IP-1，在本标准里不做具体要求。
4.914接口
本接口为统一通信的即时通信与业务网关之间的接口，属于系统的内部接口，在本标准中不做具体要求。
4.1015接口wwW.bzxz.Net
本接口为统一通信的即时通信功能与语音通信功能之间的接口，通过开放本接口，语音通信功能可以与即时通信功能进行集成，对用户的呈现状态进行订阅和发布。支持的功能如下：a）支持语音业务功能根据用户的通话状态发布用户的状态信息。b）支持语音业务功能查询用户的呈现状态信息。提供查询权限管理机制，支持根据语音业务功能的权限限定其所能查询的范围。查询可以通过订阅来实现。c）支持语音业务功能订阅用户的状态信息，并在用户状态改变时将用户的最新状态通知语音业务功能。这样语音业务功能可以根据用户当前的呈现状态进行来话管理。本接口采用SIP方式，具体接口要求见第7章。5C接口
5.1C1接口的功能
语音通信功能与客户端UE之间的C，接口采用SIPMessage消息以及XCAP协议。其中SIPMessage消息携带XML消息体实现预设电话、点击呼叫、实时显示呼叫进展状态、呼叫过程中的用户控制：XCAP协议实现预先设置来话时用户的同振顺振号码、设置通信规则和呼叫路由策略。建筑321---标准查询下载网
YD/T2305-2011
5.2SIPMessage消息头+XML消息体5.2.1SIP消息通信
SIP消息通信为交互方式，根据具体业务操作的不同，消息既可以由客户端UE发起，也可以由语音通信功能发起。
客户端UE发起的SIP消息涉及到的业务操作，包括预设请求、点击呼叫请求、挂断成员请求、结束呼叫请求、拒绝接听、应答接听、应答转移、呼叫保持请求、呼叫恢复请求。流程如图2所示。UE
1.Message
语音通信功能
图2客户端UE发起的SIP消息流程语音通信功能发起的SIP消息涉及到的操作，包括预设响应、点击呼叫响应、点击呼叫状态、挂断成员响应、结束呼叫响应、新呼叫通知、呼叫保持响应、呼叫恢复响应。流程如图3所示。UE
语音通信功能
图3语音通信AS发起的SIP消息流程5.2.2消息体
5.2.2.1消息体内容
消息体包含XML文本，其中包含Action等命令参数，请求对方进行某些控制操作，例如预设电话、点击呼叫、来电接听、呼叫转接、呼叫保持等。5.2.2.2预设电话
通过预设电话，UE可以对其语音通话的拨打和接听终端进行设置，语音终端可设置的范围为工作电话、移动终端、电脑、或临时输入的其他电话号码。预设电话的XML消息体编码格式见附录A。5.2.2.3点击呼叫
通过点击呼叫，UE可以点击通讯录、通话历史记录或输入被叫地址等发起呼叫，并且可以得到呼叫进展状态。
点击呼叫的XML消息体编码格式见附录A。5.2.2.4来电接听与转移
通过来电接听与转移，当UE在线时，如果其业务号码有来电（主叫为B），UE将提示用户进行处理，处理方式可以包括接听、拒绝、转接三种。来电接听与转移的XML消息提编码格式见附录A。5.2.2.5呼叫保持与恢复
通过呼叫保持与恢复操作，UE可以保持预设电话与远端的通话，此时远端将听到等待音。针对处于保持状态的通话，UE可以将其恢复。此时预设电话与远端恢复正常通话。4
呼叫保持与恢复的XML消息提编码格式见附录A。5.3XCAP
5.3.1XCAP协议
YD/T2305-2011
通过XCAP协议，可以实现设置用户的第一终端、第二终端，并设置用户自已的通信规则。语音业务根据通信规则、设置的终端以及用户的在线状态，进行相应的共振、顺振处理。XCAP协议具体内容见IETFRFC4825。
5.3.2设置终端
5.3.2.1流程
设置用户第一、第二终端的XCAP流程如图4所示。UE
语音通信功能
。修改用户个人信息
2.未认证
3。嫌改用户个人信息（带认证）4.修改成功
图4设置用户终端流程
流程说明：
1）客户端UE发起修改用户个人信息的请求给语音通信功能，要求修改一个用户的个人信息。个人信息中包括了需要设置/修改的第一终端和第二终端。2）由于客户端UE首次发起的修改用户个人信息的请求，其中没有包含认证信息，语音通信功能需要对该客户端进行鉴权，并返回客户端尚未认证的信息。3）客户端UE再次发起修改用户个人信息的请求给语音通信功能，这次请求中包含了认证信息。4）语音通信功能进行必要的认证和个人信息变更后，返回客户端修改成功的信息，表示修改成功。5.3.2.2参数和Schema
HTTP方法：PUT
消息体的Schema：com：ctc:ims-pim，具体格式参见附录B。5.3.3设置通信规则
5.3.3.1流程
设置通信规则的XCAP流程如图5所示。UE
语音通信功能
1.修改用户通信规则
2.未认证
3.修改用户通信规则（带认证）4.修改成功
图5通信规则修改流程
建筑321---标准查询下载网
jz32L.net
YD/T2305-2011
流程说明：
1）客户端UE发起修改用户通信规则的请求给语音通信功能，要求修改一个用户的通信规则。该请求中包括了需要修改的用户通信规则：2）由于客户端UE首次发起的修改用户通信规则的请求，其中没有包含认证的信息，语音通信功能需要对该客户端进行认证，并返回客户端尚未认证的信息。3）客户端UE再次发起修改用户通信规则的请求给语音通信功能，这次请求中包含了认证信息。4）语音通信功能进行必要的认证和通信规则信息变更后，返回客户端修改成功的信息，表示修改成功。
5.3.3.2参数和Schema
HTTP方法：PUT
消息体的Schema：com：ctccomrule，具体格式参见附录B。6C4接口
6.1WebServices消息结构
6.1.1总体结构描述
C4接口采用WebServices方式。每一个消息交互过程都有一个请求（request）和一个响应（response）收到请求后，接收方需要立即响应。由于应用需要获得呼叫的状态，业务网关通过NOTIFY方式通知应用当前的呼叫状态，此时接口的实现者为第三方应用，具体见6.1.3.6节。考虑到实现的难度，本标准也提供了第三方应用获取呼叫的状态接口，此时的接口实现者仍为业务网关，该接口实时性和效率相对较低，具体见6.1.3.7节。WebService接口的格式统一如下：6.1.1.1请求（request)
消息部分
RequestHeader
RequestBody
6.1.1.2响应（response）
消息部分
ResponseHeader
ResponseBody
6.1.2消息头结构
6.1.2.1标示定义
请求消息头
消息内容
请求消息体，可选字段，见具体消息的描述消息内容
相应消息头
请求消息体，可选字段，见具体消息的描述消息头中包含RequestID、ServiceKey、SPID、SERVICEID、TimeStamp、HashCode等标识，其定义如下：
a）RequestID定义
消息流水号，用于匹配一对请求消息和响应消息。在发起请求消息时，发起方生成流水号，并填充在请求消息中：接收方收到请求后，在响应消息填入该流水号。为了保证消息流水的全局唯一性和实现简单性，建议使用UUID。
b）ServiceKey定义数据类型为枚举型，定义如下。5
ServiceError
THIRDPARTYCALL.bindCallingPartyRequestTHIRDPARTYCALL.bindCallingPartyResponseTHIRDPARTYCALL.makeCallRequestTHIRDPARTYCALL.makeCallResponseTHIRDPARTYCALL.notifyCallInformationRequestTHIRDPARTYCALL.notifyCalInformationResponseTHIRDPARTYCALL.GetCallInformationRequestTHIRDPARTYCALL.GetCallInformationResponsec）TimeStamp定义
业务异常
预设请求
预设回复
发起呼叫请求
发起呼叫回复
呼叫状态通知请求
呼叫状态通知回复
获取呼叫状态请求
获取呼叫状态响应
YD/T2305-2011
时间戳，用于防止重复攻击。格式为YYYYMIMDDHH24MISS的14位时间字符串。d）HashCode定义
Hash码，用于防止消息篡改攻击。接口描述的接口请求和应答的消息中，对于请求和应答中对传递的信息进行Hash运算（MD5算法），形成HashCode，用于标志请求和应答信息没有被篡改过。HashCode的生成方法HashCode=HA（SPID+key+TimeStamp），其中，加号“+”表示字符串的连接，连接后的字符串并不包括加号：Key是分配给SP的密钥，在SP和接入网关间共享。进行MD5运算时需要把字符串以UTF-8编码方式转化为byte数组后再运算。6.1.2.2下行接口消息头定义
型可选
RequestID
ServiceKey
SERVICEID
TimeStamp
HashCode
xsd:string
xsd:string
xsd:string
xsd:string
xsd:string
xsd:string
6.1.2.3上行接口消息头定义
RequestID
ServiceKey
SERVICEID
TimeStamp
HashCode
xsd:string
xsd:string
xsd:string
xsd:string
xsd:string
xsd:string
请求流水号
命令或响应类型
SP标识
SP提供的业务ID，是业务规格的唯一标识时间戳，防止重复攻击
Hash码，防止消息算改攻击
请求流水号
命令或响应类型
SP标识
SP提供的业务ID，是业务规格的唯一标识时间戳，防止重复攻击
Hash码，防止消息篡改攻击
建筑321---标准查询下载网
jz32i.net
YD/T2305-2011
6.1.3第三方呼叫（THIRDPARTYCALL）消息体结构6.1.3.1功能简述
第三方呼叫业务能力引擎在接口中可以指定主叫号码、被叫号码发起呼叫。在呼叫发起过程中，可以通过接口实时返回呼叫进行的状态和结果，包括：“呼叫正在接续”、“通话已建立”、“呼叫已经结束”、“呼叫失败”及呼叫失败原因等。6.1.3.2序列图
第三方呼叫是一个应用，通过应用提供的操作界面，在两个电话间发起呼叫。图6展示了一个基本呼叫的建立和结束以及呼叫状态通知。6.1.3.3公用数据结构定义
6.1.3.3.1calllnformation
含义：呼叫类型信息
数据类型为结构，定义如下：
CallStatus
StartTime
Duration
TerminationCause
CallStatus
DateTime
Integer
CallTerminationCause
6.1.3.3.2 callStatus
含义：呼叫状态
数据类型为枚举，定义如下：
CalInitial
CallConnected
CallTerminated
6.1.3.3.3callTerminationCause含义：呼叫结束原因
数据类型为枚举，定义如下：
CallingPartyNoAns wer
CalledPartyNoAnswer
CallingPartyBusy
CalledPartyBusy
CallingPartyNotReachable
CalledPartyNotReachable
CallHangUp
CallAborted
呼叫当前状态
呼叫开始的时间[当（caliStatusCalllnitial）时]呼叫时长（秒）
呼叫结束的原因
呼叫正在发起
呼叫已建立
呼叫已结束
主叫无应答
被叫无应答
主叫忙
被叫忙
主叫不可达
被叫不可达
任意一方挂机导致呼叫结束
呼叫终止（其他的任何原因）
应用发起呼叫
未接通前可以取消呼叫
makeCallRequest
makeCallResponse
业务网关+
语音通信功能
notifyCallnformationRequest
notifyCalllnformationResponscancelCallRequest
cancelCaliResponse
notifyCalllnformationRequestnotifyCallnformationResponse通话中
endCallRequest
endCallResponse
notifyCallinformationRequestnotifyCallnformationResponse图6第三方呼叫序列图
6.1.3.4预设（bindCallingParty）接口描述6.1.3.4.1bindCallingParty操作说明呼叫主叫
主叫挂机
挂机应答
呼叫被叫
主被叫挂机
挂机应答
第三方通过bindCallingParty指示语音通信平台预设用户接听号码。接口名称
接口描述
请求ServiceKey
应答ServiceKey
接口标识
发起呼叫接口
BindCallingParty
THIRDPARTYCALL.bindCallingPartyRequestTHIRDPARTYCALL.bindCallingPartyResponseBindCallingParty
建筑321---标准查询下载网
jz32i.net
YD/T2305-2011
振铃、接通
振铃、接通
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。