CPSP接口开发培训

ISAG规范概述SMS业务能力接口介绍MMS业务能力接口介绍LCS业务能力接口介绍WapPush业务能力接口介绍主要内容主要内容AC业务能力接口介绍TPC业务能力接口介绍CN业务能力接口介绍ECC业务能力接口介绍USSD业务能力接口介绍TS业务能力接口介绍Payment业务能力介绍Presence业务能力接口介绍ISAG规范概述ISAG即综合业务接入网关，将中国电信的网络能力高度抽象，向CP/SP提供标准、统一的业务开发接口，支持电信自营增值业务、第三方CP/SP增值业务及企业应用的接入。目前，ISAG规范包括12个业务能力，即：SMS、MMS、LCS、WapPush、AC、CN、TPC、ECC、TS、USSD、Payment、Presence。ISAG所有业务能力都是通过WebService调用来实现的，各个业务能力有个公共部分即SOAP头结构，SOAP头分为上行SOAP头和下行SOAP头，主要携带一些SPID、SPPwd、ServiceID等基本信息以便ISAG进行鉴权。ISAGAPI的实现方式WEBSERVICE网络应用程序，使用SOAP协议实现。SOAP简单的理解，就是这样的一个开放协议SOAP=RPC+HTTP+XML：采用HTTP作为底层通讯协议；RPC作为一致性的调用途径，XML作为数据传送的格式，允许服务提供者和服务客户经过防火墙在INTERNET进行通讯交互。WSDL-WebServiceDescriptionLanguageWebService的描述语言，WSDL定义了一套基于XML的语法，将Web服务描述为能够进行消息交换的服务访问点的集合。ISAG－WEBSERVICEWebService：SAG与CP/SP间，实现北向接口部分，主要作用是向CP/SP提供标准、统一的业务开发接口。其主要功能是将标准的ParlayX接口封装为内部接口，并通过PCH将接口的同步处理方式转换为异步处理方式，将请求发送给平台，以便平台进行相应的业务处理ISAG组网图Webservice就是一个应用程序，它向外界暴露出一个能够通过Web进行调用的API。这就是说，你能够用编程的方法通过Web来调用这个应用程序。开发工具有Jbuilder、eclipse、gsoap等。Request/ResponseMessageRequest调用远端对象的某个方法Response返回该方法运行后的输出结果UserSOAPRequestSOAPResponseServiceProviderWebServiceISAGAPI的实现方式SOAPHEADER参数SPID：StringSPID由ISAG提供（在ZXINSAG用户的SAG_SPINFO里改。）SPPAAWORD：SAG_SPINFOstringSP密码（MD5加密）MD5加密算法如下：SP密码＝SPID+密匙＋时间戳密匙部分由ISMP分配，时间戳由发端设备生成；格式为MMDDHHMMSS,月日时分秒SERVICEID：SAG_SERVICEINFO业务IDOA：定购参数，群发时不填，单发时必填sag_msisdnrange业务订购地址，群发时不填；FA付费地址URL：WEBSERVICE的地址ADDRESSES：目的地址，如要发给哪个手机。SENDERADDR：SP的ACCESSCODE，也就是发到手机上显示的号码。在ZXINSAG用户的SAG_SERVICEINFO表里可以修改。CAPABILITYCONFIG里：TIMELEN：是发多少次；CAPABILITY：容量即发多少条timeSamp时间戳格式为：格式为MMDDHHMMSS,月日时分秒SANstring业务接入码可选；transactionId业务流水号，用户组合业务，可选；transEnd交易结束标识，用户组合业务，可选;LinkID事务关联ID用户点播业务的事务关联，由平台产生，格式如下为MMDDHHMMSS＋10位随机序列号；为空（二进制）表示无效，可选；mutiMessagingtrue：群发false：非群发（缺省）上行SOAPHEADER参数spRevpasswordSP反向调用的密码，可选SpIdSPIDSAN业务接入码serviceId业务IDtransaction业务流水号，用于组合业务linkId事务关联ID，用于点播业务的事务关联，由平台产生，格式为为MMDDHHMMSS＋10位随机序列号；可选spRevIdsp反向调用名，可选；ISAG规范介绍SMS业务能力接口介绍MMS业务能力接口介绍LCS业务能力接口介绍WapPush业务能力接口介绍主要内容SMS业务能力接口介绍概述下行接口介绍上行接口介绍概述SMS业务能力接口定义了短信业务能力集，包括应用端发起的能力集合以及网络侧发起的能力集合。用户登录短消息门户网站，使用该服务。用户编辑短信，点击发送。门户和GW间通过短信API，完成短信服务过程。GW会将短信中心传送回来的短信状态，通知APP。用户可以通过门户网站查询得知短信发送的状态，序列图如下：终端用户门户网站SAGSMS服务登录portal，使用短信功能发送短信请求短信发送标识短信发送状态报告用户查询短信发送状态报告下行接口介绍（1）1)SendSmssendSms向签约用户发送短消息,业务触发条件由应用提供商与签约用户进行预先约定，参数如下：Addresses目的地址（或地址集合），SenderName短消息发送者的信息Charging可选参数。应用于本消息的计费应用可指定计费方案名称，由此确定这条短消息对谁计费以及金额几何Message短消息内容ReceiptRequest指示是否需要网络侧返回递交状态报告网关根据第三方的要求用NotifySmsDeliveryStatus返回状态报告。对本接口的调用，网关应返回RequestIdentifier,标示该短消息的发送请求。如果消息的长度大于可支持的最大长度，此条消息将被分成若干条连续的短消息进行发送。下行接口介绍（2）2)GetSmsDeliveryStatus通过调用GetSmsDeliveryStatus，可以查询之前requestIdentifier标识的SMS发送的状态。状态信息在deliveryStatus参数中返回，它与requestIdentifier标识的请求相关的一组状态信息。状态由用户地址和相关的发送状态共同标识。即使状态达到最终值，这个方法仍可被应用多次调用。然而，状态达到最终值之后，状态信息只在有限的期间内可用，超过该期间，业务接入网关抛出策略异常。其中，返回的状态包括：DeliveredToTerminal、DeliveredToNetwork、DeliveryImpossible、Authpricefailed等。下行接口介绍（3）3)GetReceivedSms通过调用GetReceivedSms，应用可以通过网关获得所有满足registrationIdentifier标识准则的短消息。每执行一次该方法，网关将返回给应用的短消息从网关上删除。此外，每条短消息在某个最大时间间隔后，会从服务器上自动删除。这个最大的时间间隔在离线配置阶段定义。接收到的短消息信息在receivedSms参数中返回，其中包含短消息的发送者、内容和终端用来发送消息的目标地址。上行接口介绍（1）上行接口是由业务接入网关发起的、到业务应用服务器的调用。4)NotifySmsDeliveryStatus业务应用服务器先前向网关发送了短消息，如果带有ReceiptRequest字段，则当网关获得状态报告时，即调用本接口将短消息的递交状态报告给应用。该状态报告以ReceiptRequest.Correlator和DeliveryStatus的组合进行标识。状态信息在DeliveryInformation中具体描述。上行接口介绍（2）5)NotifySmsReception业务触发条件由应用提供商与运营商进行预先约定，当业务接入网关收到发给特定地址的短消息时，即调用本接口，将短消息发送给业务应用服务器。notifySmsReception由业务接入网关调用，将短消息的接收通知应用。仅当收到的短消息满足预先约定的提供准则时，网关才会发出通知。这个提供准则由registrationIdentifier进行标识。短消息通过SMSMessage标识，包括参数Message标识短消息的内容，参数SmsServiceActivationNumber，即能被应用‘监视’的短消息的目的地址，参数SenderAddress包含了发送者地址。应用可采取适当的业务逻辑来处理收到的短消息。应用提交短消息流程应用提交短消息的调用流程上图为应用提交短消息的调用流程：1-6）CP/SP提交SMS发送请求给SAG，应答在接入认证完成(10)或向SMSC提交(14)之后返回；7-10）SLP通过ISMAP模块向ISMP进行鉴权批价处理，当鉴权失败时，直接进入21通知CP/SP鉴权失败；11-14）SLP通过SMPP模块向SMSC提交短消息，返回成功后将信息入库；15-18）收到来自SMSC的短消息回执；19-22）SLP通过ISMAP模块向ISMP进行鉴权批价确认处理；23-28）SLP向CP/SP返回发送状态报告（不要求状态报告时无此流程）。注：接入认证见后图。ISAG规范介绍SMS业务能力接口介绍MMS业务能力接口介绍LCS业务能力接口介绍WapPush业务能力接口介绍主要内容MMS业务能力接口介绍概述下行接口介绍上行接口介绍概述MMS业务能力接口定义了彩信业务能力集，包括应用端发起的能力集合以及网络侧发起的能力集合。彩信和短信的流程基本类似，区别在于彩信消息中可以包含图片、文本等附件。用户登录一个卡通图片业务门户网站，为过生日的好友选择祝福卡片，并编辑祝福短信后，点击彩信发送。图片门户与MMS服务间通过API交互完成彩信的发送。同时，MMS服务会将彩信中心返回的状态报告通知给图片门户，这样用户可通过门户网站查询彩信发送的状态。下行接口介绍（1）下行接口是由业务应用服务器发起、到业务接入网关的调用。1)SendMessage业务触发条件由应用提供商与签约用户进行预先约定，由应用根据业务需要在恰当时刻调用本接口，给用户发送一条彩信。本消息调用是请求发送一条彩信到一组地址集合，并返回RequestIdentifier对本消息的发送进行标识。网关根据第三方的要求用notifyMessageDeliveryStatus返回状态报告，并使用RequestIdentifier与先前发送的消息相关联。彩信的内容是作为一个SOAP附件进行发送。第三方通过ReceiptRequest告知网关是否需要返回状态报告。下行接口介绍（2）2)GetMessageDeliveryStatus通过调用GetMessageDeliveryStatus，可以查询之前requestIdentifier标识的MMS发送的状态。状态信息在deliveryStatus参数中返回，它与requestIdentifier标识的请求相关的一组状态信息。状态由用户地址和相关的发送状态共同标识。即使状态达到最终值，这个方法仍可被应用多次调用。然而，状态达到最终值之后，状态信息只在有限的期间内可用，超过该期间，业务接入网关抛出策略异常。其中，返回的状态包括：DeliveredToTerminal、DeliveredToNetwork、DeliveryImpossible、Authpricefailed等。下行接口介绍（3）3)GetReceivedMessages这个操作是使用一个特殊的注册标识符获得一组新的消息。该请求参数为RegistrationIdentifier和优先参数（Priority，可选），返回一个MessageRefere