广东联通_CPSP接口开发培训

ParlayX规范介绍WebService模块和流程SMS业务能力接口介绍MMS业务能力接口介绍LCS业务能力接口介绍WapPush业务能力接口介绍主要内容ParlayX规范介绍什么是ParlayX规范什么是Parlay规范OSA/ParlayX与ParlayX的区别ParlayXAPI的实现方式什么是ParlayX规范1).OSA/Parlay是由3GPP、ESTI和Parlay组织制定的一组标准APIs。OSA即OpenServiceAccess，业务开放接入。2).Parlay标准规定了Parlay应用程序接口（API）的体系结构、提供的业务、各业务能力特征(SCF)中各个方法的主要功能、典型业务的呼叫流程等方面的要求。3).Parlay规范的制订是为了使得通讯工程师和IT工程师都能够开发出电信应用软件。ParlayAPI的特点是能够使得第三方用户不用了解基础网络所采用的具体技术和协议，只要知道基础网络能够提供什么样的能力并利用这些能力，就可以开发出多种多样的业务。什么是Parlay规范4).ParlayAPI的版本较多，比较具有影响力的版本是2.1和3.x,然而目前作为主流开发基础的ParlayAPI规范，内容庞大和复杂，比较难以掌握，根据统计，目前80%的Parlay业务只用到了20%的ParlayAPI。5).Parlay提供的业务能力特征主要分为以下几类：呼叫控制SCF：包括一般呼叫控制业务、多方呼叫控制业务等用户交互SCF：包括基本用户交互和呼叫用户交互SCF、基本用户交互接口类移动SCF：用户位置接口类等用户状态接口类数据会话控制SCF帐户管理SCF计费SCF…什么是Parlay规范1).目前80%的Parlay业务只用到了20%的ParlayAPI。另一方面，当前，运营商、制造商和用户对NGN上的Web业务都表现出了极大的兴趣，为此Parlay工业论坛专门成立了一个ParlayX的工作组搜集需求并制定相应的开发计划。2).2002年11月，Parlay4.0规范发布了一个WSDL的绑定。在2002年11月，Parlay小组发布了一系列面向Web服务的白皮书。3).2003年4月，一个构建电信应用的Web服务标准－Parlay-X规范发布了，它主要是用于简化目前的Web服务规范。什么是ParlayX规范什么是ParlayX规范4).ParlayX对原来的ParlayAPI经过高度的抽象和封装，定义了一组功能强大，但又简单、抽象和极富想象力的电信能力API，以便于通信开发人员和IT开发人员都能快速地理解和掌握，并在此基础上开发出具有创新意义的电信应用软件。5).ParlayX采用WebServices的方式，应用与实现ParlayXWebServices的服务器（也称做“ParlayX网关”）之间的交互方式采用基于XML的消息交换来实现；消息交换由应用发起，并且遵循同步的“请求/响应”模型。当然，ParlayXWebServices服务器到应用的“响应”是可选的，根据实际的应用需求而定。然而，对于应用服务器作为被动方的消息通知类型的业务，就需要定义异步消息，以实现消息从ParlayX网关到应用的消息传递。ParlayXAPI和ParlayAPI的架构关系目前，OSA/ParlayX正式发布的版本号是2.0，未正式发布的有2.1和3.0（3.0只在ETSI官方网站上找到两个草拟文档，TPC和Presence），在此，以OSA/ParlayX2.0为主，OSA/ParlayX2.1为辅，将其和ParlayX最新规范V1.2进行比较。总的来说，两者提供的业务能力不完全相同、某些相同的业务能力中接口参数及服务策略不同。OSA/ParlayX与ParlayX的区别OSA/ParlayX与ParlayX的区别OSA/ParlayX2.0提供的业务能力如下：1)Thirdpartycall2)CallNotification3)ShortMessaging4)MultimediaMessaging5)Audiocall6)TerminalStatus7)Terminallocation8)Accountmanagement9)Callhandling10)Payment11)Multimediaconference12)Addresslistmanagement13)PresenceParlayX2.0提供的业务能力如下：1)ThirdPartyCall2)WAPPush3)SMS4)MMS5)AudioCall6)TerminalLocation7)EnhanceCall8)CallNotification9)USSD10)TerminalStatus11)SmartCall12)PresenceParlayX规范介绍WebService模块和流程SMS业务能力接口介绍MMS业务能力接口介绍LCS业务能力接口介绍WapPush业务能力接口介绍主要内容ParlayXAPI的实现方式WEBSERVICE网络应用程序，使用SOAP协议实现。SOAP简单的理解，就是这样的一个开放协议SOAP=RPC+HTTP+XML：采用HTTP作为底层通讯协议；RPC作为一致性的调用途径，ＸＭＬ作为数据传送的格式，允许服务提供者和服务客户经过防火墙在INTERNET进行通讯交互。WSDL-WebServiceDescriptionLanguageWebService的描述语言，WSDL定义了一套基于XML的语法，将Web服务描述为能够进行消息交换的服务访问点的集合。Webservice就是一个应用程序，它向外界暴露出一个能够通过Web进行调用的API。这就是说，你能够用编程的方法通过Web来调用这个应用程序。开发工具有Jbuilder、eclipse、gsoap等。Request/ResponseMessageRequest调用远端对象的某个方法Response返回该方法运行后的输出结果UserSOAPRequestSOAPResponseServiceProviderWebServiceParlayXAPI的实现方式业务系统和SP/CP的接口综合增值业务平台业务系统和SP/CP的接口的结构，包括3个部分：业务系统与SP/CP的接口：ParlayX部分业务系统对SP/CP的开放接口以ParlayX2.0为基础，采用WebService技术封装。业务能力可以灵活部署和扩展，可以随着业务承载网络的增加而增加。业务能力包括数据业务能力、语音业务能力和组合业务能力。数据业务能力ShortMessage、MultimediaMessage、TerminalStatus、TermianlLocation、USSD和WAPPush。话音业务能力ThirdPartyCall、CallNotification、CallHanding、AudioCall。业务系统和SP/CP的接口组合业务能力组合业务能力是将一些通用的组合业务逻辑或者复杂的业务逻辑开发实现。可以在业务系统内部实现也可以基于业务系统的WebService接口在系统外部实现。例如利用ShortMessage和CallNotification两个业务能力实现被叫用户忙短信通知手机用户等业务系统与SP/CP的接口：ParlayAPI部分业务系统与SP/CP的接口：现有系统部分即联通现有系统和SP/CP的接口在业务接入层保留了SP调用联通现有的WAPPull功能的接口SOAPHEADER介绍VASP业务能力都是通过WebService调用来实现的，各个业务能力有个公共部分即SOAP头结构，SOAP头分为上行SOAP头和下行SOAP头，主要携带一些SPID、SPPwd、ServiceID等基本信息以便VASP进行鉴权。下行SOAPHEADERSpIdStringSPID在CP与ISMP注册时提供，同时同步给Parlay/ParlayX网关将SPID入库；SPPASWORD：SP密码MD5加密（SP密码＝SPID+密匙＋时间戳）密匙部分由ISMP分配，时间戳由发端设备生成，格式为MMDDHHMMSS月日时分秒；timeStamp时间戳格式MMDDHHMMSS月日时分秒；ServiceId业务的IDSPNumber业务接入码；可选SessionID业务流水号，用于组合业务。可选SessionEnd交易结束标识，用于组合业务。可选；SOAPHEADER介绍LinkID事务关联ID，用于点播业务的事务关联，由平台产生，格式MMDDHHMMSS＋10位随机序列号；如为空表示无效。可选OA业务订购地址。群发时不填FA付费地址。可选GroupMessaging：群发false非群发，缺省为false上行SOAPHEADER参数SPrevIDSP反向调用名，可选；SPrevpasswordSP反向调用密码，可选SpIdSPIDSPNumber业务接入码SessionId业务流水号LinkID事务关联IDParlayX规范介绍SMS业务能力接口介绍MMS业务能力接口介绍LCS业务能力接口介绍WapPush业务能力接口介绍主要内容SMS业务能力接口介绍概述下行接口介绍上行接口介绍概述SMS业务能力接口定义了短信业务能力集，包括应用端发起的能力集合以及网络侧发起的能力集合。当前，为了接收和发送短消息，在写应用时必须使用专门的协议来接入网元（例如，短消息中心）提供的SMS功能。这种方式要求对网络有高度的专业知识。另一种方式是，使用Parlay/OSA方式调用标准接口（例如用户交互或消息服务接口）来接入到SMS能力，但是这些接口通常对IT应用开发商来说过于复杂。开发商必须掌握高级电信技能才能使用OSA接口.现在采用发送和接收短消息的ParlayXWebService：WebService的范围就是以简单的方式为应用开发商提供处理短消息的原语。应用调用一个API给网络发送消息（参见SendSMSAPI）。网关采用非同步的通知机制将短消息递交状态告知应用。通过使用这个SMSWebService，应用开发商不需要专门的电信知识，就能调用短消息功能。下行接口介绍下行接口SendSms包括4个实现方法：SendSms:应用发送短消息；SendSmsLogo：应用发送短消息logo；SendSmsRingtone：应用发送短消息ringtone；GetSmsDeliveryStatus：应用获取短消息发送状态下行接口介绍（1）1）SendSmssendSms向签约用户发送短消息,业务触发条件由应用提供商与签约用户进行预先约定，参数如下：Addresses目的地址（或地址集合），SenderName短消息发送者的信息Charging可选参数。应用于本消息的计费应用可指定计费方案名称，由此确定这条短消息对谁计费以及金额几何Message短消息内容ReceiptRequest指示是否需要网络侧返回递交状态报告网关根据第三方的要求用NotifySmsDeliveryStatus返回状态报告。对本接口的调用，网关应返回RequestIdentifier,标示该短消息的发送请求。如果消息的长度大于可支持的最大长度，此条消息将被分成若干条连续的短消息进行发送。下行接口介绍（2）2）sendSmsRingtone业务触发条件由应用提供商与签约用户进行预先约定，由应用根据业务需要在恰当的时刻调用本接口，向签约用户发送短消息ringtone。sendSmsRingtone调用是请求发送一条短消息的ringtone到一个指定的地址，该短消息由字符型的参数ringtone（RTX格式）描述，目的地址由Address描述。应用可以通过SenderName指示的短消息发送者信息。应用可指定计费方案名称chaging，由此确定这个短消息的ringto