【YD通讯标准】 基于 ParLay X 应用程序接口的个人应用业务的技术要求

通信标准类技术报告
YDB027-2008
基于ParLayX应用程序接口的个人应用业务的技术要求
TheTechnical Requirements for Personal Applications based onParlayXAPI2008-11-12印发
中国通信标准化协会发布
1范围
2规范性引用文件
3缩略语..
4业务实现机制
4.1ParlayX应用的系统架构.
4.2ParlayX应用的业务提供过程，5信息管理类应用
5.1个人通信录管理，
5.1.1建立通信录分组
5.1.2删除通信录分组，
5.1.3查询通信录分组，
5.1.4组属性管理
5.1.5组成员管理
5.1.6组成员属性管理
5.1.7建立多个管理账号
5.1.8黑/白名单管理，
5.1.9语音转接规则设置
5.2个人帐户管理，
6呼叫服务类应用
6.1点击拨号.
6.2呼叫转接
6.3日程提醒，
6.4彩铃
7信息服务类应用
7.1消息服务.
7.2位置服务.
8支付类应用
9应用与网关接口流程
9.1个人通信录管理
9.2个人账户管理，
9.3点击拨号..
9.4呼叫转接
9.5日程提醒，
9.6彩铃.
9.7消息服务
9.8位置服务.
9.9个人支付.，
YDB027—2008
本技术报告是ParlayX业务系列技术报告之一，该系列技术报告预计结构如下：1）基于ParlayX应用程序接口的个人应用业务的技术要求2)基于ParlayX应用程序接口的企业应用业务的技术要求YDB0272008
为适应信息通信业发展对通信标准文件的需要，在信息产业部统一安排下，对于技术尚在发展中，又需要有相应的标准性文件引导其发展的领域，由中国通信标准化协会组织制定“通信标准类技术报告”，推荐有关方面参考采用。有关对本技术报告的建议和意见，向中国通信标准化协会反映。本技术报告由中国通信标准化协会提出并归口。本技术报告起草单位：中国电信集团公司、中兴通讯股份有限公司、华为技术有限公司、上海贝尔阿尔卡特股份有限公司。
本技术报告主要起草人：凌颗、陈荆花、赵飞、胡捷、赵志洪、白超波。H
1范围
YDB0272008
基于ParLayX应用程序接口的个人应用业务的技术要求本技术报告规定了基于ParlayX应用程序接口的个人类通信增值应用的技术要求。本文描述了使用ParlayX类接口进行应用开发的实现机制，从信息管理、呼叫服务、信息服务、支付等4个方面，面向个人用户的通信信息需求，归纳了个人通信录管理、个人账户管理、点击拨号、语音转接、语音日程提醒、彩铃、消息服务、位置服务、小额支付等9类基本通信增值应用，并提出了接口要求、消息流程。本技术报告适用于基于ParlayX应用程序接口的个人应用业务。2规范性引用文件
下列文件中的条款通过本技术报告的引用而成为本技术报告的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本技术报告，然而，鼓励根据本技术报告达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本技术报告。
YD/T1661-2007基于互联网服务（WebService）的开放业务接入应用程序接口（ParlayX）技术要求
3缩略语
下列缩略语适用于本技术报告。API
4业务实现机制
ApplicationProgrammingInterfaceIntelligentNetworkApplicationProtocolInternetProtocol
InteractiveVoiceResponse
Open Service Access
PublicSwitchedTelephoneNetworkSessionInitiationProtocol
ServiceLevel Agreement
Short MessageService
WirelessApplicationProtocol
4.1ParlayX应用的系统架构
应用程序接口
智能网应用协议
互联网协议
交互式语音应答
业务开放接入
公共电话交换网
会话初始协议
服务等级协定
短消息业务
无线应用协议
ParlayX应用采用相对简单统一的Parlayx接口见图1），通过ParlayXWebServices网关与现有网络的网络单元进行交互，从而利用运营商的基础网络提供丰富多彩的业务。ParlayXWebServicesAPIs位于现有网络之上，使得业务开发者不必关心电信承载网络的复杂性。YDB027—2008
主要设备功能：
Parlay宠用服务器
ParlryAPts
Parlay/OSA网关
ParlayXWeh
ServicesAPls
PaniayX应用服务善
ParlayXWebServices润
两络持教
（伊虹SIP、INAP等）
现有网络
五联网
图1实现ParlayX应用的系统架构a)ParlayX应用服务器
实现各种ParlayX应用，通过ParlayXWebServicesAPIs与ParlayXWebServices网关交互，指示运营商的各种业务网络及业务平台执行业务流程，完成业务的逻辑控制，从而实现丰富的应用业务b）ParlayXWebServices网关
在运营商的各种业务网络，业务平台与ParlayX应用服务器之间进行业务逻辑的转换和协议的映射，使得ParlayX应用服务器能够通过统一的ParlayXWebServicesAPIs与各种业务网络进行信息交互，进行业务逻辑控制，而不必考虑各种业务网络复杂的接口协议。ParlayXWebServices网关可以直接与网元连接，也可以通过Parlay网关与网元连接。ParlayXWebServices网关与应用服务器之间的接口为ParlayXWebServicesAPIs，与Parlay网关之间的接口为ParlayAPIS，与现有网络的网络单元之间的协议采用各个网络的现有协议。c）Parlay/OSA网关
Parlay/OSA网关为ParlayXWcbServices网关提供与运营商网络进行信息交互的一种可选途径，使得ParlayXWebServices网关能够通过统一的ParlayAPIs与各种业务网络进行信息交互，从而简化了ParlayXWebServices网关的实现。4.2ParlayX应用的业务提供过程ParlayX应用业务的提供，涉及到网络运营商、业务开发商与最终的应用提供商三类角色：a)网络运营商提供基础网络与ParlayXWebServices网关，向业务开发商发布ParlayX业务能力对应用提供商及其提供的应用进行安全、完整、有效、可控的管理，通过双方的协议，确保ParlayX应用能够有效地运营、计费：b）业务开发商利用网络运营商发布的ParlayX业务能力，开发各类ParlayX应用：2
YDB027——2008
c）应用提供商从业务开发商处获取ParlayX应用，与网络运营商签订业务接入及经营管理协议，对自已提供的ParlayX应用进行市场运营。其中，网络运营商也可以兼任业务开发者或最终的应用提供商。服务提供商
4.应用提供商与运营商之闻签
订接入及运营管理协议
3.应用提供高购买业务开发商的应用6.应用提供商将应用部器
服务器上
ParlayX应用服务器
9.PartiayX应用通过关进行业务迎辑控制，完成对用户的服务
网络运营商
ParlayXWebServices网关
7.应用向管理平台进行注
册，完成鉴权认证
8.当用户使用时
应用通过
管理采台完成技人验
管理平台
加网络运营商发布新
的ParleyX业务能力
5.运营商根据与应用提供商签订的协议向管理平合配置数据
图2ParlayX应用的实现过程
业务开发商
2.业务开发商发现网络
运营商提供的ParlayX能力
集，进行业务开发
ParlayX是一组应用接口。在网络运营商、业务开发商与最终的应用提供商之间，还需要有一套ParlayX应用的管理平台及相关机制，提供认证、授权、计费、SLA（服务等级协议）和其他与环境相关的功能。ParlayX应用从接口能力发布到应用部署实施可经历以下过程：a）能力发布：网络运营商将ParlayX为表现形式的网络能力通过管理平台向业务开发商发布，公告在业务开发过程中可使用的网络能力：业务开发：业务开发商使用网络运营商发布的ParlayX接口能力集开发各种应用业务：b)
应用提供商向业务开发商获取ParlayX应用：应用提供商通过与网络运营商的协商，达成ParlayX应用对指定网络能力接入协议与业务运营d)
管理协议：
网络运营商根据协议向管理平台部署相关信息e
应用提供商将ParlayX应用部署到ParlayX应用服务器上，根据接入协议，ParlayX应用应能获f
得被授权的网络业务能力特征的信息，找到适合应用需求的网络业务能力的ParlayXWebService网关：
ParlayX应用向管理平台注册，完成鉴权认证：g）
当用户使用应用提供商的服务时，ParlayX应用向管理平台进行接入鉴权：鉴权完成后，ParlayX应用通过网关进行业务逻辑控制，完成对用户的服务。此类管理机制解决的业务发布、鉴权认证等问题，不属于本技术报告提供范围。本技术报告旨在归纳常见的电信增值业务，以ParlayX接口的方式加以实现，更为复杂的业务实现可以通过这些基本应用的组合获得
本技术报告从信息管理、呼叫服务、信息服务、支付等4个方面归纳了9个基本应用，这些应用可以相对独立，也可以有机地结合、提供更为复杂的应用逻辑。例如可以在查询位置信息时应用可通过多媒体消息将购物地图发送给用户，用户可根据相应的信息进行支付类业务。3
YDB0272008
5信息管理类应用
5.1个人通信录管理
运营商在电信网络内为用户建立通信录，将通信录的管理权限开放给应用提供商。应用提供商可向用户提供Web、WAP、SMS、IVR等多种接入方式，将用户对通信录的管理信息递交给运营商网络内的通信录服务器，并接收通信录服务器以ParlayX接口返回的信息，以各种形式呈现给用户，从而达到在网络与用户进行信息交互的目的。5.1.1建立通信录分组
用户向个人通信录建立多个联系人分组，并为每个分组命名。用户可以在特定的分组中添加下一级分组。例如，用户在建立了公司、同学、亲戚分组后，可以在公司分组中进一步按公司部门添加下一级联系人分组，在同学分组中添加高中、大学等分组。用户可以设定策略，在为联系人分组命名时，假如出现重名，通信录服务器可以拒绝建立分组，或按用户默认设置在指定名称后面添加后缀。5.1.2删除通信录分组
用户可以删除指定的联系人分组，存在该分组中的所有下一级分组及联系人的分组关联信息也随之删除。
5.1.3查询通信录分组
用户可以查询指定的分组信息。用户可以设定策略，要求仅返回指定分组中的下一级分组信息，或返回指定分组中敏的所有组信息。5.1.4，组属性管理
用户可对特定组添加自定义属性：并对组属性进行删除或查询。5.1.5组成员管理
用户可以向特定组添加、删除、修改、查询联系人信息。5.1.6组成员属性管理
用户可对特定组的特定成员添加自定义属性，并对组属性进行删除或查询。例如，用户可对通信录中的联系人自行添加姓名、性别、群组、单位、电话号码、职业、电子邮件爱好、生日等属性。
5.1.7建立多个管理账号
用户可赋予指定账号以下权力：管理自己通信录中的特定分组；?查询特定组中的成员：
向特定组中添加/删除/修改联系人信息。用户可撤销原先赋予指定账号的权力。用户应能查询对指定账号所做的权限设置。例如，用户在建立公司、同学、亲戚分组后，可以赋予每个同学对自已的信息进行修改的权限。5.1.8黑/白名单管理
用户可以设置黑名单地址列表，系统对来自黑名单上的联系人来电自动予以拒绝。用户可以设置白名单地址列表，系统仅将白名单上的来电转接给用户。5.1.9语音转接规则设置
用户可以对自已的一个或多个号码设定呼叫的无条件前转地址，以及当无条件前转到的终端忙或无应答时的备选前转地址。
用户可以对自己的一个或多个号码设定呼叫的忙或无应答前转地址，以及当前转到的终端忙或无应答时的备选前转地址。
YDB027—2008
用户可以选择对自已的一个或多个号码的呼叫播放语音留言，留言的内容用户可以通过文本输入进行指定、或指定语音文件播放。用户可以查询自已的语音转接规则设置。5.2个人帐户管理
用户可以向网络递交对指定账户的充值请求，并对充值金额进行限定。用户可以充值账户余额。
用户可以查询个人账户余额、账户中止日期。6呼叫服务类应用
6.1点击拨号
用户在查看应用提供商通过Web/WAP方式呈现的联系人信息时，应能通过点击联系人名称或电话号码尝试向对方发起呼叫。应用提供商向网络递交用户的点击拨号请求，由网络分别呼叫双方、接通话路。
6.2呼叫转接
用户可以对自己的一个或多个终端的来电指定同振顺振规则：?同振：系统将来电同时接续到两个以上指定终端。顺振：系统将来电按顺序接续到指定终端：当接续到一个终端的电话忙或无应答时，再接续到下一个终端，以此类推。
用户可以对自已的一个或多个终端的来电指定转接规则，如5.1.9的描述。在系统收到对用户的来电时，将按预设的前转规则将来电前转到指定终端。6.3日程提醒
用户可以使用应用提供商提供的语音日程提醒服务。用户通过应用提供商提供的各种接入手段（WEB/WAP/SMS）对自已的日程安排进行设置。应用提供商在用户指定的时刻，向用户发起呼叫、播放日程安排：或向用户发送含有日程安排信息的短消息或多媒体消息。6.4彩铃
用户可以在应用提供商提供的应用中指定对来电启用彩铃，并可指定铃音文件。当应用提供商收到对用户的来电时，指示网络向用户播放特定的彩铃音。7信息服务类应用
7.1消息服务
用户可以通过应用提供商提供的平台发送短消息，并通过应用提供商界面收到短消息回执。用户可以订阅应用提供商的信息服务，应用提供商按用户需求发送特定内容的短消息或多媒体消息到用户指定终端。
应用提供商也可以接收发送给用户的消息，以用户指定的形式呈现给用户浏览。用户可以使用应用提供商提供的即时消息服务，查看通信录中的联系人在线状态，并向联系人接收发送即时消息。
7.2位置服务
用户可通过该类应用获取与自已或他人的位置或位置变化相关的服务信息。在用户订阅此类服务信息后，应用提供商向运营商网络发起定位请求，并将获得的经纬度等地理位置信息转换为用户易认知的位置信息，也可按服务约定向其中添加更多的增值服务信息，通过短消息、彩信等约定的方式发送给用户。
用户可以通过临时请求一次性获取服务，也可通过事先约定而周期性获取：可以获得单点位置信息或运动轨迹信息，或与之相关的其他服务信息，例如餐厅分布、行车地图。5
YDB027-2008
8支付类应用
用户可使用应用提供商提供的支付类应用。应用提供商的服务费用通过运营商的代收费服务来收取。应用提供商向用户提供服务后，将收费对象、金额、相关信息递交给运营商，运营商进行代收费。用户也可预查询费用。用户将用户账户、服务类型、流量数量通过应用提供商向网络进行查询，从而获知自己已需要支付的费用。用户也可申请对特定业务预留费用。用户申请预留费用时，应用提供商将用户账户、预留金额递交给网络。在用户使用业务时，应用提供商向网络申请在预留金额中扣除费用。用户也可查询、撤销预留费用。9应用与网关接口流程
本文采用的ParlayX接口应符合YD/T1661-2007的规定。9.1个人通信录管理
个人通信录业务可采用地址列表管理及呼叫处理接口实现。地址列表管理接口提供建立管理分组及联系人信息功能，呼叫处理接口提供黑/白名单管理及呼叫前转等规则的设置功能。
a）用户通过应用提供商应用提供的管理界面管理组（创建、删除）：GW
个人通信录管理
createGroupRequest(StringName,StringDomain,StringAutoname)返回创建结果
返回删除结果
流程说明：
2.createGroupResponse(anyURIResult)3.deleteGroupRequest(anyURIGroup)4.deleteGroupResponse0
图3管理通信录群组
创建群组
影除群组
1）用户通过应用提供商提供的管理界面创建新的群组。应用根据用户在界面上输入的信息，调用\createGroup\接口。传递的参数包括：Name为要创建的群组的名称（比如：大学同学、中学同学），Domain为群组所在的域（比如：同学），Autoname为是否自动命名能力（Autonam心=true，表示名称重复时，则应用自动给名称添加一个后级，在结果中返回具有唯一性的名称：Autoname一false，表示名称重复时，应用抛出异常）：ParlayX网关创建群组成功后，通过\CreateGroupResponse\将创建的结果返回给应用，其2)
中接口中传递的Result为创建群组的最终的合格名称：用户通过管理界面删除群组，应用调用“deleteGroup\接口，将其中的Group参数设置为要3）
删除的群组的名称：
4）Parlayx网关删除群组成功后，返回删除结果。用户通过管理界面管理组成员（增加、删除、设置成员权限）：b）
返回增加结
返回删除结果
返回设置结察
流程说明：
L.addMemberRequest(anyURIGroup,anyURI Members)2.addMemcberResponse
3.deleteMemberRequest(anyURIGroup.anyURIMembers)4.deleteMemcbcrResponse(
5.setAccesisRequest(anyURIGroup.stringRequester,booleanAdminPermissionbooleanAddPemission,booleanDeletePermission,booleanQueryPemission6.setAccessResponse)
图4管理组成员
YDB027—2008
个人通信录
增加群组成员
删除群维成员
设置成员权限
1）用户通过应用提供的管理界面增加新的群组成员。应用调用\addMember\接口，传递的参数包括：Group为要加入的群组的名称（比如：大学同学），Member为添加到组中的成员名称；下载标准就来标准下载网
2）ParlayX网关增加用户成功后，通过\addMemberResponse\接口将用户增加的结果返回给应用：
3）用户通过应用提供的管理界面删除新的群组成员。应用调用\deleteMember\接口，传递的参数包括：Group为用户所在的群组的名称（比如：XXXX部门），Member为要删除的成员的名称：
4）ParlayX网关删除用户成功后，通过deleteMemberResponse\接口将用户删除的结果返回给应用：
用户通过应用提供的管理界面赋予其它用户管理权限。应用调用“setAccess接口，传递的5）
参数包括：Group为许可权对应的组，Requester为请求获取许可权的用户，AdminPermission为管理组的许可权（AdminPermissiontrue，添加管理组的权利：AdminPermission=false，撤销管理组的权利），AddPermission向组中添加成员的许可权（AddPermission=true，添加向组中增加成员的权利：AddPemission=false，撤销向组中增加成员的权利），DeletePermission为从组中删除成员的许可权（DeletePermission三true，添加从组中删除成员的权利：DeletePermission=false，撤销从组中删除成员的权利），QueryPermission为查询组中成员的许可权（QueryPermission一true，添加查询组中成员的权利：QueryPemission二false，撤销查询组中成员的权利）；6）Parlayx对请求进行处理后返回结果。用户通过管理界面查询其它用户对自已通信录的管理权限：e
YDB027—2008
返回查询结果
流程说明：
L.queryAccessRequest(anyURIGroup.stringRequester)2.queryAccessResponse(AccessiPermissionsPermissions)图5查询管理权限
个人通信录管理
查询成员权限
1）用户通过管理界面查询其它用户的管理权限。应用调用\queryAccess\接口，传递的参数包括：Group为许可权对应的组，Requestor为成员名称；2）ParlayX网关查询后通过\queryAccessResponse\返回该成员所有的许可权列表Pemissions（值可以为AdminPermission，AddPermission、DeletePermission、QueryPermission中的一个或多个）。
d）被赋予管理权限的用户通过查询界面查询特定群组成员信息：GW
返回查询结果
1.queryMembersRequest(anyURI Group, boolean ResolveGroup)2.queryMembersResponse(anyURI members)图6查询群组成员信息
个人通信录管理
查询群组成员
流程说明：
1）其它被赋予通信录管理权限的用户通过查询界面查询某一群组的成员，应用调用“qucryMembers\接口，其中Group为要查询的组；2）ParlayX网关查询后通过“queryMembersResponse\中的members参数返回该群组所有的成员列表。
9.2个人账户管理
个人账户管理服务采用账户管理接口。GW
L.BalanceUpdateReguestanyURIEndUeridentifier,stringEnderUserPin, stringRferenceCode,decimal Amount)2.BalanceUpdateResponseo
图7帐户管理流程
个人账户管理
流程说明：
1）用户请求对指定账户进行充值。应用调用balanceUpdate接口，其中EndUserldentifier定义用户指定更新的账户，EndUserPin代表用户凭证（例如信用卡），ReferenceCode是应用生成的流水号，Amoumt是用户指定的账户金额：8
YDB027—2008
2）网关收到后，将相关信息递交给网络，对用户在运营商侧的账户进行资金充值，并向应用返回处理结果。
9.3点击拨号
点击拨号业务可采用第三方呼叫或增强型呼叫接口实现。第三方呼叫接口用于应用一次性地创建呼叫，不能对呼叫的进展情况作进一步的处理，也无法利用网络的专有资源同用户提供服务增强型呼叫接口可提供较为复杂的呼叫业务逻辑，应用可对后续呼叫进行更多控制，例如当点击援号的呼叫不成功时，应用可通过分析不成功的原因，将用户前转到其它的号码、或者向用户启动语音交互流程，等等。
场景1：点击拨号应用
不控制呼叫后续进程》
创建呼叫
场景2：点击拨号应用
控制呼叫后续进程）
创建呼叫
上报与用户语
音交互结果
1.MakeCaliRequest(anyURICallingPartyanyURICalledParty)
2.MakeCaliResponse(string Callldentifier)3.enMakePowerCallRequest(anyURICallingParty,PowerActionAction)
4.enMakePowerCallResponse(string Callldentifier)5.enHandleUIEventRequest(string Calldentifier, anyURICallingParty,UIValue UiValue)6.enHandleUIEventResponse(PowerActionAction)7.enHandleUIEventRequest(stringCallldentifier,anyURI上报与用户语CallingPartyUIValueUiValue)音交互结果
8.enHandleUIEventResponse(PowerActionAction)图8点击拨号流程
流程说明：
场景一，应用不控制呼唤后续流程：点击拨号
发起呼叫
发起呼叫，并通
过Action参数指
示用户交互
指示继续进行
用户语音交互
指示结束呼叫
1）用户点击应用提供的WEB/WAP界面上的联系人，应用调用makeCall接口，其中callingParty为用户本人的电话，ealledParty为界面上的联系人电话2网关向应用返回呼叫标识号，便于应用对呼叫处理结果进行查询。场景二，应用控制呼唤后续流程：用户点击应用提供的WEB/WAP界面上的联系人，应用调用enMakePowerCall接口，其中callingParty为用户本人的电话：Action中的actionToPerform值取为RunUI，指示网关要发起个与用户的语音交互，Action的resourceAddress下带的子参数取为脚本交互模式并给出脚本地址，例如addressTypeURL，addressValue-\http..”2)
网关向应用返回呼叫标识号，便于应用对后续收到的呼叫结果进行处理：当呼叫进行到一定阶段，网关调用enHandleUIEvent接口向应用上报用户交互的结果，其中3)
Calldentifier用于保持呼叫关联，UiValue中携带了语音交互的结果，例如当有收号时，子参数uiResult=ULCollectNum，表示UI交互正常结束，有收号，子参数uiCollection中携带收到的号的具体值：
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。