CPSP接口开发培训课件

路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索04 五月 2024CPSP接口开发培训接口开发培训路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索n ISAGISAG规范概述规范概述n SMS SMS业务能力接口介绍业务能力接口介绍n MMS MMS业务能力接口介绍业务能力接口介绍n LCS LCS业务能力接口介绍业务能力接口介绍n WapPush WapPush业务能力接口介绍业务能力接口介绍主主 要要 内内 容容路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索主主 要要 内内 容容nACAC业务能力接口介绍业务能力接口介绍nTPCTPC业务能力接口介绍业务能力接口介绍nCNCN业务能力接口介绍业务能力接口介绍nECCECC业务能力接口介绍业务能力接口介绍nUSSDUSSD业务能力接口介绍业务能力接口介绍nTSTS业务能力接口介绍业务能力接口介绍nPaymentPayment业务能力介绍业务能力介绍nPresencePresence业务能力接口介绍业务能力接口介绍路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索ISAGISAG 规范概述规范概述nISAGISAG即综合业务接入网关，将中国电信的网络能力高度抽象，向即综合业务接入网关，将中国电信的网络能力高度抽象，向CP/SPCP/SP提供标准、统一的业务开发接口，支持电信自营增值业务、第提供标准、统一的业务开发接口，支持电信自营增值业务、第三方三方CP/SPCP/SP增值业务及企业应用的接入。增值业务及企业应用的接入。n目前，目前，ISAGISAG规范包括规范包括1212个业务能力，即：个业务能力，即：SMSSMS、MMSMMS、LCSLCS、WapPushWapPush、ACAC、CNCN、TPCTPC、ECCECC、TSTS、USSDUSSD、PaymentPayment、PresencePresence。nISAGISAG所有业务能力都是通过所有业务能力都是通过WebServiceWebService调用来实现的，各个业务能调用来实现的，各个业务能力有个公共部分即力有个公共部分即SOAPSOAP头结构，头结构，SOAPSOAP头分为上行头分为上行SOAPSOAP头和下行头和下行SOAPSOAP头，主要携带一些头，主要携带一些SPIDSPID、SPPwdSPPwd、ServiceIDServiceID等基本信息以便等基本信息以便ISAGISAG进进行鉴权。行鉴权。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索ISAG APIISAG API的实现方式的实现方式nWEB SERVICEWEB SERVICE网络应用程序，使用网络应用程序，使用SOAPSOAP协议实现。协议实现。nSOAPSOAP简单的理解，就是这样的一个开放协议简单的理解，就是这样的一个开放协议SOAP=RPC+HTTP+XMLSOAP=RPC+HTTP+XML：采：采用用HTTPHTTP作为底层通讯协议；作为底层通讯协议；RPCRPC作为一致性的调用途径，作为一致性的调用途径，XMLXML作为数作为数据传送的格式，允许服务提供者和服务客户经过防火墙在据传送的格式，允许服务提供者和服务客户经过防火墙在INTERNETINTERNET进行通讯交互。进行通讯交互。nWSDL-Web Service Description LanguageWSDL-Web Service Description LanguageWeb ServiceWeb Service的描述语言，的描述语言，WSDL WSDL 定义了一套基于定义了一套基于 XML XML的语法，将的语法，将WebWeb服务描述为能够进行消息交换的服务访问点的集合。服务描述为能够进行消息交换的服务访问点的集合。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索ISAGWEBSERVICEnWeb Service：SAGSAG与与CP/SPCP/SP间，实现北向接口部分，主要作用间，实现北向接口部分，主要作用是向是向CP/SPCP/SP提供标准、统一的业务开发接口。提供标准、统一的业务开发接口。n其主要功能是将标准的其主要功能是将标准的ParlayXParlayX接口封装为内部接口，并通过接口封装为内部接口，并通过PCHPCH将接口的将接口的同步处理方式转换为异步处理方式，将请求发送给平台，以便平台进行相同步处理方式转换为异步处理方式，将请求发送给平台，以便平台进行相应的业务处理应的业务处理路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索ISAG组网图组网图路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索nWeb service Web service 就是一个应用程序，它向外界暴露出一个能够通过就是一个应用程序，它向外界暴露出一个能够通过WebWeb进行调进行调用的用的APIAPI。这就是说，你能够用编程的方法通过。这就是说，你能够用编程的方法通过WebWeb来调用这个应用程序。来调用这个应用程序。开发工具有开发工具有JbuilderJbuilder、eclipseeclipse、gsoapgsoap等。等。nRequest/Response MessageRequest/Response MessageRequest Request 调用远端对象的某个方法调用远端对象的某个方法Response Response 返回该方法运行后的输出结果返回该方法运行后的输出结果User SOAP RequestSOAP ResponseServiceProviderWebServiceISAG APIISAG API的实现方式的实现方式路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索SOAPHEADER参数参数nSPID：String SP ID 由ISAG提供（在ZXINSAG用户的SAG_SPINFO里改。）nSPPAAWORD：SAG_SPINFO string SP密码（MD5加密）nMD5 加密算法如下：nSP密码SPID+密匙时间戳 密匙部分由ISMP分配，时间戳由发端设备生成；格式为MMDDHHMMSS,月日时分秒nSERVICEIDSERVICEID：SAG_SERVICEINFO SAG_SERVICEINFO 业务业务IDID nOA：定购参数，群发时不填，单发时必填 sag_msisdnrange业务订购地址，群发时不填；nFA 付费地址nURL：WEBSERVICE的地址nADDRESSES：目的地址，如要发给哪个手机。nSENDERADDR：SP的ACCESSCODE，也就是发到手机上显示的号码。在ZXINSAG用户的SAG_SERVICEINFO表里可以修改。nCAPABILITY CONFIG里：nTIMELEN：是发多少次；nCAPABILITY：容量即发多少条ntimeSamp 时间戳 格式为：格式为MMDDHHMMSS,月日时分秒nSAN string 业务接入码 可选；ntransactionId 业务流水号，用户组合业务，可选；ntransEnd 交易结束标识，用户组合业务，可选;nLinkID 事务关联ID 用户点播业务的事务关联，由平台产生，格式如下为MMDDHHMMSS10位随机序列号；为空（二进制）表示无效，可选；nmuti Messaging true：群发 false：非群发（缺省）路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行上行SOAPHEADER参数参数 nspRevpassword n SP反向调用的密码，可选反向调用的密码，可选nSpId SPIDnSAN 业务接入码业务接入码nserviceId 业务业务IDntransaction 业务流水号，用于组合业务业务流水号，用于组合业务nlinkId 事务关联事务关联ID，用于点播业务的事务关联，由平台产生，用于点播业务的事务关联，由平台产生，格式为为格式为为MMDDHHMMSS10位随机序列号；可选位随机序列号；可选nspRevId sp反向调用名，可选；反向调用名，可选；路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索n ISAG ISAG规范介绍规范介绍n SMSSMS业务能力接口介绍业务能力接口介绍n MMS MMS业务能力接口介绍业务能力接口介绍n LCS LCS业务能力接口介绍业务能力接口介绍n WapPush WapPush业务能力接口介绍业务能力接口介绍主主 要要 内内 容容路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索SMSSMS业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索概概 述述n SMS业务能力接口定义了短信业务能力集，包括应用端发起的能力集合以及网络侧发起的能力集合。n用户登录短消息门户网站，使用该服务。用户编辑短信，点击发送。门户和GW 间通过短信API，完成短信服务过程。GW 会将短信中心传送回来的短信状态，通知APP。用户可以通过门户网站查询得知短信发送的状态，序列图如下：终端用户终端用户门户网站门户网站SAG SMSSAG SMS服务服务登录portal，使用短信功能发送短信请求短信发送标识短信发送状态报告用户查询短信发送状态报告路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍下行接口介绍（1）1)SendSms nsendSms向签约用户发送短消息,业务触发条件由应用提供商与签约用户进行预先约定，参数如下：Addresses 目的地址（或地址集合），SenderName 短消息发送者的信息 Charging 可选参数。应用于本消息的计费应用可指定计费方案名称，由此确定这条短消息对谁计费以及金额几何 Message 短消息内容 ReceiptRequest指示是否需要网络侧返回递交状态报告网关根据第三方的要求用NotifySmsDeliveryStatus 返回状态报告。n对本接口的调用，网关应返回RequestIdentifier,标示该短消息的发送请求。n如果消息的长度大于可支持的最大长度，此条消息将被分成若干条连续的短消息进行发送。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（2）2)GetSmsDeliveryStatusn通过调用GetSmsDeliveryStatus，可以查询之前requestIdentifier 标识的SMS 发送的状态。状态信息在deliveryStatus 参数中返回，它与requestIdentifier标识的请求相关的一组状态信息。状态由用户地址和相关的发送状态共同标识。n即使状态达到最终值，这个方法仍可被应用多次调用。然而，状态达到最终值之后，状态信息只在有限的期间内可用，超过该期间，业务接入网关抛出策略异常。n其中，返回的状态包括：DeliveredToTerminal、DeliveredToNetwork、DeliveryImpossible、Authpricefailed等。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（3）3)GetReceivedSmsn通过调用GetReceivedSms，应用可以通过网关获得所有满足registrationIdentifier 标识准则的短消息。n每执行一次该方法，网关将返回给应用的短消息从网关上删除。此外，每条短消息在某个最大时间间隔后，会从服务器上自动删除。这个最大的时间间隔在离线配置阶段定义。n接收到的短消息信息在receivedSms 参数中返回，其中包含短消息的发送者、内容和终端用来发送消息的目标地址。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍（上行接口介绍（1）上行接口是由业务接入网关发起的、到业务应用服务器的调用。4)NotifySmsDeliveryStatusn业务应用服务器先前向网关发送了短消息，如果带有ReceiptRequest 字段，则当网关获得状态报告时，即调用本接口将短消息的递交状态报告给应用。n该状态报告以 ReceiptRequest.Correlator 和DeliveryStatus 的组合进行标识。状态信息在DeliveryInformation 中具体描述。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍（上行接口介绍（2）5)NotifySmsReceptionn业务触发条件由应用提供商与运营商进行预先约定，当业务接入网关收到发给特定地址的短消息时，即调用本接口，将短消息发送给业务应用服务器。nnotifySmsReception 由业务接入网关调用，将短消息的接收通知应用。仅当收到的短消息满足预先约定的提供准则时，网关才会发出通知。这个提供准则由registrationIdentifier 进行标识。n短消息通过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返回发送状态报告（不要求状态报告时无此流程）返回发送状态报告（不要求状态报告时无此流程）。注：接入认证见后图。注：接入认证见后图。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索n ISAG ISAG 规范介绍规范介绍n SMS SMS业务能力接口介绍业务能力接口介绍n MMSMMS业务能力接口介绍业务能力接口介绍n LCS LCS业务能力接口介绍业务能力接口介绍n WapPush WapPush业务能力接口介绍业务能力接口介绍主主 要要 内内 容容路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索MMSMMS业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索概概 述述 MMS业务能力接口定义了彩信业务能力集，包括应用端发起的能力集合以及网络侧发起的能力集合。彩信和短信的流程基本类似，区别在于彩信消息中可以包含图片、文本等附件。n用户登录一个卡通图片业务门户网站，为过生日的好友选择祝福卡片，并编辑祝福短信后，点击彩信发送。图片门户与MMS 服务间通过API 交互完成彩信的发送。n同时，MMS 服务会将彩信中心返回的状态报告通知给图片门户，这样用户可通过门户网站查询彩信发送的状态。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍下行接口介绍（1）下行接口是由业务应用服务器发起、到业务接入网关的调用。1)SendMessage n业务触发条件由应用提供商与签约用户进行预先约定，由应用根据业务需要在恰当时刻调用本接口，给用户发送一条彩信。n本消息调用是请求发送一条彩信到一组地址集合，并返回RequestIdentifier 对本消息的发送进行标识。n网关根据第三方的要求用notifyMessageDeliveryStatus 返回状态报告，并使用RequestIdentifier 与先前发送的消息相关联。n彩信的内容是作为一个SOAP 附件进行发送。第三方通过ReceiptRequest 告知网关是否需要返回状态报告。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（2）2)GetMessageDeliveryStatusn通过调用GetMessageDeliveryStatus，可以查询之前requestIdentifier 标识的MMS 发送的状态。状态信息在deliveryStatus 参数中返回，它与requestIdentifier标识的请求相关的一组状态信息。状态由用户地址和相关的发送状态共同标识。n即使状态达到最终值，这个方法仍可被应用多次调用。然而，状态达到最终值之后，状态信息只在有限的期间内可用，超过该期间，业务接入网关抛出策略异常。n其中，返回的状态包括：DeliveredToTerminal、DeliveredToNetwork、DeliveryImpossible、Authpricefailed等。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（3）3)GetReceivedMessagesn这个操作是使用一个特殊的注册标识符获得一组新的消息。n该请求参数为RegistrationIdentifier和优先参数（Priority，可选），返回一个MessageReference数组，其中包括每条彩信的彩信标识、主题、发送方地址、目的地址等。n通过该操作，应用可以获取特定标识的彩信基本信息，并依据各个彩信的标识进一步获取彩信URI地址组及彩信附件。n绑定不同注册标识符参数是一个不在线的处理过程。Parlay X 网关不允许使用一个未与应用关联的注册标识符获取消息。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（4）4)GetMessageURIsn这个操作将依据MessageRefIdentifier读取消息的不同部分，在业务接入网关建立本地文件并且返回URI 标识。n应用可以仅仅读取每个文件或将其以链接的形式呈现给最终用户。5)GetMessagen这个操作将依据MessageRefIdentifier这个操作将读取整条消息。n在返回的消息中，数据以附件形式返回。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍（上行接口介绍（1）上行接口是由业务接入网关发起的、到业务应用服务器的调用。6)NotifyMessageDeliveryReceiptn业务应用服务器先前向网关发送了彩信，网关对该消息的发送分配了一个标识符RequestIdentifier。当网关获得状态报告时，即调用本接口将彩信的递交状态报告给应用。n本接口的调用是将先前递交彩信的状态报告告知应用，该彩信以RequestIdentifier 和DeliveryStatus 的组合进行标识。状态信息在DeliveryInformation 中具体描述。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍（上行接口介绍（2）7)NotifyMessageReceptionn业务触发条件由应用提供商与运营商进行预先约定，当业务接入网关收到发给特定地址的消息时，即调用本接口，将消息发送给业务应用服务器。n当网关收到发送到特定业务激活号码的新消息时，将把消息作为附件通知到应用。n参数RegistrationIdentifier标识业务激活号码，Message标识与接收消息相关的所有信息。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索n ISAG ISAG 规范介绍规范介绍n SMS SMS业务能力接口介绍业务能力接口介绍n MMS MMS业务能力接口介绍业务能力接口介绍n LCSLCS业务能力接口介绍业务能力接口介绍n WapPush WapPush业务能力接口介绍业务能力接口介绍主主 要要 内内 容容路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索LCSLCS业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索概概 述述 LCS业务能力接口定义了定位业务能力集，包括应用端发起的能力集合以及网络侧发起的能力集合。定位业务能力集可分为一下三类：n位置信息同步查询：应用向GW 查询一个或一组用户位置信息，网关同步返回位置信息告知应用。n位置信息异步查询（事件触发）：应用调用一次位置请求，指定范围区域。在查询周期内，用户进入指定区域或离开指定区域，网络将上报用户位置信息。n位置信息异步查询（周期性触发）：应用可以调用一个API 请求，网络按一定频率周期性上报用户位置信息。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍下行接口介绍（1）下行接口是由业务应用服务器发起、到业务接入网关的调用。LCS下行接口可分为两类：定位信息同步查询和定位信息异步查询。1)GetLocation n定位信息同步查询接口，查询一个终端用户的位置信息，参数如下：nAddresses：需定位的终端地址；nRequestedAccuracy：要求精度，以米为单位；nAcceptableAccuracy：可接受的精度，以米为单位。n定位结果通过LocationInfo返回给应用，包括经度、纬度以及终端地址等。其中，纬度值以浮点数（-90.0000-+90.0000）形式表示，单位为十进度的度（方向与分钟和秒钟相反），正值表示赤道以北，负值表示赤道以南。n经度值以浮点数（-180.0000-+180.0000）形式表示，单位为十进度的度（方向与分钟和秒钟相反），正值表示本初子午线（格林威治）以东，负值表示本初子午线（格林威治）以西，直到第180 条子午线。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（2）2)GetTerminalDistancen定位信息同步查询接口，查询一个与某个特定位置间的距离，该特定的位置以经度和纬度来表示，参数如下：nAddress：终端地址nLatitude：指定位置的纬度nLongitude:指定位置的经度n返回终端与指定点间的距离，以米为单位。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍下行接口介绍（3）3)GetLocationForGroupn定位信息同步查询接口，和接口GetLocation类似，区别在于GetLocationForGroup可以获取一组终端用户的位置信息，参数和GetLocation一样。n定位结果通过LocationData数组返回给应用，其中除了包含LocationInfo中的基本信息外，还包括位置报告状态ReportStatus以及错误值ErrorInformation（当ReportStatus 为“Error”时有效）。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（4）4)StartGeographicalNotificationn定位信息异步查询接口（事件触发），用于请求GW 以一定原则上报一个或多个终端的位置信息。报告上报的原则为用户进入或离开指定的区域。n该请求的参数包括终端地址组、原点的经纬度、范围的半径、产生报告的原则、是否立即查询、上报最大频度、最大时长以及上报次数等。n业务接入网关收到该请求后，通过LocationNotification按照应用的要求上报终端位置信息，错误信息通过LocationError上报应用，上报结束时调用LocationEnd通知应用。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（5）5)StartPeriodicNotificationn定位信息异步查询接口（周期性触发），用于请求GW 按照一定的精度周期性上报一个或多个终端的位置信息。n该接口和区域定位类似，也是通过LocationNotification等接口通知应用定位结果。6)EndNotificationn请求GW 停止周期性或事件触发性的上报一个或多个用户的状态信息。n周期性及事件触发性定位请求中将该请求的异步位置查询的请求标识（Correlator）带给业务接入网关，应用通过该标识通知GW停止上报。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍（上行接口介绍（1）上行接口是由业务接入网关发起的、到业务应用服务器的调用。7)LocationNotificationn该接口用于业务接入网关向应用返回需要查询的终端用户位置信息。n该通知消息通过参数Correlator和应用下发的周期性或事件触发异步位置查询请求相关联，位置信息放在LocationInfo数组中，当请求是事件触发的异步位置查询请求时，通过Criteria参数指明当前位置上报的原则。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍（上行接口介绍（2）8)LocationErrorn该接口用于业务接入网关查询用户位置消息出现错误时，通知业务应用服务器。n该通知消息通过参数Correlator和应用下发的周期性或事件触发异步位置查询请求相关联，参数Address指明错误报告对应的终端地址，Reason指明错误原因。9)LocationEndn当位置报告的最大时长或者次数到时，则GW 结束周期性监视状态。n接口通过参数Correlator和应用下发的周期性或事件触发异步位置查询请求相关联。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索n ISAG ISAG 规范介绍规范介绍n SMS SMS业务能力接口介绍业务能力接口介绍n MMS MMS业务能力接口介绍业务能力接口介绍n LCS LCS业务能力接口介绍业务能力接口介绍n WapPushWapPush业务能力接口介绍业务能力接口介绍主主 要要 内内 容容路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索WapPushWapPush业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索概概 述述 WapPush业务能力接口定义了WapPush业务能力集，包括应用端发起的能力集合以及网络侧发起的能力集合。WapPush和短信的流程基本类似，基本业务流程如下：n应用程序向业务接入网关提交推送请求，业务网关返回请求标识。n应用程序可以根据返回的请求标识主动向业务接入网关查询状态，也可以等待业务接入网关发出推送结果通知。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍下行接口介绍（1）下行接口是由业务应用服务器发起、到业务接入网关的调用。1)SendMessage n本操作请求把一个消息的URL 地址推送到一组目标地址，并且返回一个请求标识（requestIdentifier）以唯一标识这个消息。n应用程序可以稍后用requestIdentifier 查询消息状态。第三方通过ReceiptRequest 告知网关是否需要返回状态报告。n网关根据第三方的要求用notifyMessageDeliveryStatus 返回状态报告，并使用RequestIdentifier 与先前发送的消息相关联。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（2）2)GetMessageDeliveryStatusn通过调用GetMessageDeliveryStatus，可以查询之前requestIdentifier 标识的推送请求的处理状态。状态信息在deliveryStatus 参数中返回，它与requestIdentifier标识的请求相关的一组状态信息。状态由用户地址和相关的发送状态共同标识。n即使状态达到最终值，这个方法仍可被应用多次调用。然而，状态达到最终值之后，状态信息只在有限的期间内可用，超过该期间，业务接入网关抛出策略异常。n其中，返回的状态包括：DeliveredToTerminal、DeliveredToNetwork、DeliveryImpossible、Authpricefailed等。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍上行接口介绍上行接口是由业务接入网关发起的、到业务应用服务器的调用。3)NotifyMessageDeliveryReceiptn本操作向客户端应用程序通知推送结果。n本接口的调用是将先前递交的推送请求的状态报告告知应用，该短消息以RequestIdentifier 和DeliveryStatus 的组合进行标识。状态信息在DeliveryInformation 中具体描述。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索n ACAC业务能力接口介绍业务能力接口介绍n TPC TPC业务能力接口介绍业务能力接口介绍n CN CN业务能力接口介绍业务能力接口介绍n ECC ECC业务能力接口介绍业务能力接口介绍n USSD USSD业务能力接口介绍业务能力接口介绍n TS TS业务能力接口介绍业务能力接口介绍n Payment Payment业务能力介绍业务能力介绍n Presence Presence业务能力接口介绍业务能力接口介绍主主 要要 内内 容容路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索ACAC业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索概概 述述 AC业务能力接口定义了语音呼叫业务能力集，该业务能力集只有应用端发起到业务接入网关调用的能力集合。AC提供了一种灵活的方式来传递语音信息。接口非常简单，不需要开发者去管理呼叫的产生，也不需要与呼叫交互来发送语音消息。有三种机制可以用于语音消息的内容：n文本：使用Text-To-Speech（TTS）引擎来播放n语音内容（例如，wav）：使用放音设备来播放nVoiceXML：使用VoiceXML 浏览器来播放 目前只支持VoiceXML文本放音。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍下行接口介绍（1）应用调用接口请求放音，网关返回请求标识，应用根据该关联标识查询呼叫状态，同时应用也可以根据该关联标识取消放音服务。1)PlayVoiceXmlMessagen调用该接口用于创建一个到用户的呼叫，该用户由Address标识，并且播放位于VoiceXmlUrl 的VXML 文件信息。n当系统接收到请求后，调用会立即返回结果（实际的呼叫异步进行）。返回值将被用来标识这次请求。n这个操作被用来对单个终端播放一条信息。这里提供的应该是单个终端URI，而不是群组URI。如果提供了群组URI，则应用将收到PolicyException。nPlayTextMessage、PlayAudioMessage和该接口类似，只是播放的语音内容不同。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（2）2)GetMessageStatusn调用GetMessageStatus 来得到先前请求的当前状态。先前请求由Correclator 来标识，得到MessageStatus值，指明当前播放状态为已播放、正在播放、还未播放或是发生错误。3)EndMessagen调用EndMessage 取消或停止由Correlator 标识的先前请求。返回值为Result，包含了在放弃请求时刻的状态。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索n AC AC业务能力接口介绍业务能力接口介绍n TPCTPC业务能力接口介绍业务能力接口介绍n CN CN业务能力接口介绍业务能力接口介绍n ECC ECC业务能力接口介绍业务能力接口介绍n USSD USSD业务能力接口介绍业务能力接口介绍n TS TS业务能力接口介绍业务能力接口介绍n Payment Payment业务能力介绍业务能力介绍n Presence Presence业务能力接口介绍业务能力接口介绍主主 要要 内内 容容路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索TPCTPC业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索概概 述述 TPC业务能力接口定义了第三方呼叫业务能力集，该业务能力集只有应用端发起到业务接入网关调用的能力集合。TPC描述第三方呼叫，用于创建并管理应用发起的呼叫。此Web Service 的范围就是以简单的方式为应用开发商提供创建呼叫的功能。事实上，通过使用这个第三方呼叫Web Service，应用开发商不需要掌握详细的电信知识，就能调用呼叫处理功能。基本流程：业务门户提供用户点击拨号的业务界面，用户只需通过点击网页就可以建立语音呼叫。业务网关会在业务请求收到后返回一个能唯一标识该次呼叫的参数Callidentifer。用户也可以通过业务界面停止该呼叫。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍下行接口介绍（1）1)makeCalln第三方触发一语音增值业务，通过MakeCall 指示网关发起业务呼叫。网关呼通主叫，再连接被叫。作为可选，应用还可以提供计费（charging）指示。返回的参数（callIdentifier）用于标识此呼叫，APP 可以用它来监视这个呼叫的状态，或是取消呼叫等。2)getCallInformationnAPP 调用 getCallInformation 获得指定呼叫（由callIdentifier 标识）的当前状态。n呼叫结束后，在静态配置的有效期内，网关将保存呼叫状态，以供APP查询。返回的状态信息包括呼叫状态、开始时间、时长等。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（2）3)endCallnAPP 通过呼叫标识指示网关结束makeCall 呼叫。n如果呼叫还处于初始阶段，网关将放弃呼叫。如果呼叫已经建立，网关将切断呼叫。4)cancelCallnAPP 通过呼叫标识指示网关放弃makeCall 呼叫。n如果呼叫还未建立，指示网关放弃makeCall 呼叫，如果呼叫已经建立，呼叫将不受影响。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索n AC AC业务能力接口介绍业务能力接口介绍n TPC TPC业务能力接口介绍业务能力接口介绍n CNCN业务能力接口介绍业务能力接口介绍n ECC ECC业务能力接口介绍业务能力接口介绍n USSD USSD业务能力接口介绍业务能力接口介绍n TS TS业务能力接口介绍业务能力接口介绍n Payment Payment业务能力介绍业务能力介绍n Presence Presence业务能力接口介绍业务能力接口介绍主主 要要 内内 容容路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索CNCN业务能力接口介绍业务能力接口介绍n 概述概述n 上行接口介绍上行接口介绍路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索概概 述述 CN业务能力接口定义了网络发起到第三方呼叫的业务能力集，用于处理网络中的签约用户发起的呼叫，一个第三方的应用将决定此呼叫将如何处理。CN基本是一个被叫属性触发的业务能力集，包括两类接口，四种触发方式：n接口可分为两类CallDirection和CallNotification：两类接口都是依照事先配置的事件触发呼叫，不同的是CallNotification接口是网关用来通知APP，而CallDirection中定义的接口网关不但将呼叫通知APP，并等待APP 的下一步动作指示。n触发方式包括：被叫忙触发、被叫不可达触发、被叫无应答触发和接入码触发。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍上行接口介绍（1）1)CallDirection类接口nCallDirection类接口包括四个：handleBusy、handleNotReachable、handleNoAnswer、handleCalledNumber，这四个接口的参数及返回值类型一致，只是触发方式不同。在此以handleBusy为例说明。n在一个基本呼叫中，当被叫忙时，触发智能业务。网关向APP 进行智能请求，APP 进行相关业务判断，指示网关进行动作。APP 指示网关动作有三种：Continue：正常地处理网络中的被叫忙事件 EndCall：结束呼叫 Route：重新路由到应用指定的目标地址 当应用指示的网关动作是Route时，返回的Action中还包含重新路由的地址。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上上行接口介绍（行接口介绍（2）2)CallNotification类接口nCallNotification类接口包括四个：notifyBusy、notifyReachable、notifyAnswer、notifyCalledNumber，这四个接口的参数类型一致，只是触发方式不同。在此以notifyBusy为例说明。n在一个基本呼叫中，当被叫忙时，触发智能业务，网关将被叫忙事件通知给APP。n该类请求的参数和CallDirection类接口类似，包括主叫号码、被叫号码以及主叫方名称（可选），CallNotification类接口没有返回值。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索n AC AC业务能力接口介绍业务能力接口介绍n TPC TPC业务能力接口介绍业务能力接口介绍n CN CN业务能力接口介绍业务能力接口介绍n ECCECC业务能力接口介绍业务能力接口介绍n USSD USSD业务能力接口介绍业务能力接口介绍n TS TS业务能力接口介绍业务能力接口介绍n Payment Payment业务能力介绍业务能力介绍n Presence Presence业务能力接口介绍业务能力接口介绍主主 要要 内内 容容路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索ECCECC业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索概概 述述 ECC，即enhanceCall，增强呼叫业务集，分为应用侧发起的呼叫和网络侧发起的呼叫。在Third party call和Call Notification中描述的呼叫控制API，无论是第三方发起的还是网络发起的，应用和网络的交互都是一次性的。在呼叫建立后，应用无法对呼叫的进展保持跟踪，因而也不能根据呼叫的具体进展情况作进一步的处理；同时，应用也无法利用网络专有资源向用户提供服务。这在很大程度上限制了应用开发商开发业务的灵活性和多样性。增强型呼叫控制API，以简单的方式为应用开发商提供持续控制一个呼叫的功能。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍下行接口介绍（1）下行接口即APPCall类接口，应用侧发起的呼叫，是由GW 到业务应用服务器的调用。第三方可以发起一个呼叫，也可以根据呼叫标识查询呼叫状态或结束呼叫。1)enMakePowerCalln第三方触发一语音增值业务，通过 enMakePowerCall 指示网关发起业务呼叫，并返回呼叫标识。n请求参数：callingParty(主叫号码)、action（APP指示网关的处理动作）、charging（计费标识）、suppressservices（是否抑止T_CSI）;响应消息携带呼叫标识；n用户点击网页触发语音增值业务，APP启动业务逻辑，指示网关先呼通主叫，主叫摘机应答后，网关按照action的指示处理呼叫。n若action 的指示为用户交互时，网关处理结束后必须上报APP；若action 的指示为呼叫时，APP 应指明网关是否需要上报呼叫处理结果。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（2）nAPP 指示主叫摘机应答后，网关的处理动作：RunUI 与用户语音交互 BaseCall 连接一个指定的被叫 SequenceCall 失败后，无条件顺呼 ConcurrentCall 同振2)enInterruptCalln第三方根据已建立呼叫的呼叫标识调用enInterruptCall 来指示网关中断终端正在进行的行为（放音、通话），开始一个新的处理动作，Action 为新的处理动作的指示。被中断的终端为已被连接至系统的终端。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（3）3)enGetServiceStatusn业务触发条件：APP 业务已触发，并得到了呼叫标识。n应用：应用调用 enGetServiceStatus 查询业务是否还正常进行，实现APP与GW 之间的激活测试机制。4)enEndCalln业务触发条件：APP 业务已触发，并得到了呼叫标识。n应用：APP根据呼叫标识调用enEndCall指示网关切断呼叫，结束业务呼叫服务。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍上行接口介绍（1）上行接口即NetworkCall类接口，网络侧发起的呼叫，是由GW 到业务应用服务器的调用。GW 生成呼叫标识callIdentifier，APP 根据该标识指示GW 进行放音、呼叫接续、同振、顺呼、彩铃等动作。1)enhandleACalln用户通过拨打业务接入码方式进行业务触发，GW 将业务请求通知APP。APP 收到业务请求，启动业务应用（APP），开始增值业务服务。网关将呼叫信息（主、被叫）和业务触发原因上报给APP。APP 通过业务逻辑判断，指示网关如何处理当前呼叫。n若处理的动作为用户交互时，网关处理结束后必须上报APP；若处理的动作为呼叫时，APP 需要指示网关上报呼叫处理结果，否则网关不上报。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上上行接口介绍（行接口介绍（2）网关通知APP 业务请求时，呼叫的状态为：nBusy 被叫忙nNotReachable 被叫不可达nNoAnswer 被叫无应答nOffHook 主叫摘机nServicenumber 业务接入码呼叫nCalledAuthorized MT 呼叫流程触发情况nOriginCollectedInfo MO 呼叫流程触发情况APP 指示网关的处理动作为：nEndCall 结束呼叫nRunUI 与用户语音交互nBaseCall 连接一个指定的被叫nSequenceCall 失败后，无条件顺呼nConcurrentCall 同振路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍（上行接口介绍（3）2)enhandleCallEventn业务触发条件：当网关根据应用指示对业务请求的处理动作为呼叫时，如：呼一个被叫、同振、顺呼，并且APP 指示网关呼叫处理结束后上报呼叫处理结果。n网关呼叫处理结束，通过enhandleCallEvent 上报呼叫处理结果。nAPP 收到呼叫处理结果，进行业务判断，指示网关下一步的处理动作，下一步动作和enhandleACall中的返回值一致，网关通知APP 呼叫处理结果分以下几种：Busy 呼叫失败：被叫忙NotReachable 呼叫失败：被叫不可达NoAnswer 呼叫失败：被叫无应答Offline 呼叫失败：SIP 终端离线CallSuccess 呼叫完成：被叫挂机LimitReached 呼叫完成：呼叫限制到路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍（上行接口介绍（4）3)enhandleUIEventn业务触发条件：当网关根据应用指示对业务请求的处理为进行用户交互时，如：向用户播放语音、放音收号、取VXML 脚本进行用户交互。n用户交互结束后，网关通过enhandleUIEvent 上报用户交互结果。nAPP 根据网关上报的用户交互结果进行业务判断，指示网关下一步的处理动作。下一步动作和enhandleACall中的返回值一致，网关通知APP 用户交互结果如下：用户交互结束，无收号 uiResult UI_End 用户交互结束，有收号 uiResult UI_CollectNum uiCollection 号码 用户交互失败 uiResult UI_Failure路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍（上行接口介绍（5）4)enNotifyEventn网关将被叫应答、主叫挂机等呼叫事件以通知的方式告知APP。n通知的事件包括以下几种：CalledAnswer 被叫应答Callingdisconnect主叫挂机CallingBusy主叫忙CallingNoAnswer主叫无应答CallingNotReachable主叫不可达n各个呼叫控制步骤通过上行接口参数中的呼叫标识相互关联。路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索n AC AC业务能力接口介绍业务能力接口介绍n TPC TPC业务能力接口介绍业务能力接口介绍n CN CN业务能力接口介绍业务能力接口介绍n ECC ECC业务能力接口介绍业务能力接口介绍n USSDUSSD业务能力接口介绍业务能力接口介绍n TS TS业务能力接口介绍业务能力接口介绍n Payment Payment业务能力介绍业务能力介绍n Presence Presence业务能力接口介绍业务能力接口介绍主主 要要 内内 容容路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索USSDUSSD业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索概述概述nUSSD：即（unstructured supplementary service data）；即非结构化补充数据业务。是一种基于GSM网络，可以提供综合性、交互式信息服务的数据业务!nUSSD与短消息业务（SMS）都是通过网络的信令通道传递的。不同之处在于短消息属于存储转发方式，USSD则属于面向对话方式。当用户访问USSD业务时，该对话通路保持连接，直到对话结束。nISAG USSD Web Service 用于在应用和用户之间的建立的USSD交互，以此完成一些信息的交互。nUSSD下行接口类包括如下接口类下行接口类包括如下接口类：Send Ussd nUSSD上行接口类包括如下接口类：上行接口类包括如下接口类：Network Notify路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索下行接口介绍（下行接口介绍（1 1）n接口类接口类1.Send Ussd1.Send UssdmakeUssd由应用发起的USSD请求，将USSD信息传递给网关;应用调用本接口，向网关发起USSD交互请求。USSD交互的内容UssdMessage中描述。该消息的目的地址由DestinationAddress描述。应用的请求网关返回UssdIdentifier,以使本次交互与后续的USSD交互关联起来。方法有makeUssdRequest和:makeUssdResponse路漫漫其修远兮路漫漫其修远兮,吾将上下而求索吾将上下而求索上行接口介绍（上行接口介绍（1 1）n接口类接口类2 2：N