CPSP接口开发培训(共105张)

1、1n 规范概述规范概述n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n业务能力接口介绍业务能力接口介绍n业务能力接口介绍业务能力接口介绍n业务能力接口介绍业务能力接口介绍n业务能力接口介绍业务能力接口介绍n业务能力接口介绍业务能力接口介绍n业务能力接口介绍业务能力接口介绍n业务能力介绍业务能力介绍n业务能力接口介绍业务能力接口介绍n即综合业务接入网关，将中国电信的网络能力高度抽象，向提供标即综合业务接入网关，将中国电信的网络能力高度抽象，向提供标准、统一的业务开发接口，支持电信自营增值业务、第三方

2、增值业准、统一的业务开发接口，支持电信自营增值业务、第三方增值业务及企业应用的接入。务及企业应用的接入。n目前，规范包括目前，规范包括1212个业务能力，即：、。个业务能力，即：、。 n所有业务能力都是通过调用来实现的，各个业务能力有个公共部分所有业务能力都是通过调用来实现的，各个业务能力有个公共部分即头结构，头分为上行头和下行头，主要携带一些、等基本信息即头结构，头分为上行头和下行头，主要携带一些、等基本信息以便进行鉴权。以便进行鉴权。n n网络应用程序，使用协议实现。网络应用程序，使用协议实现。n简单的理解，就是这样的一个开放协议：采用作为底层通讯协议；简单的理解，就是这样的一个开放协议：

3、采用作为底层通讯协议；作为一致性的调用途径，作为数据传送的格式，允许服务提供者和作为一致性的调用途径，作为数据传送的格式，允许服务提供者和服务客户经过防火墙在进行通讯交互。服务客户经过防火墙在进行通讯交互。 n n 的描述语言，的描述语言， 定义了一套基于定义了一套基于 的语法，将服务描述为能够的语法，将服务描述为能够进行消息交换的服务访问点的集合。进行消息交换的服务访问点的集合。n ：与间，实现北向接口部分，主要作用是：与间，实现北向接口部分，主要作用是向提供标准、统一的业务开发接口。向提供标准、统一的业务开发接口。n其主要功能是将标准的接口封装为内部接其主要功能是将标准的接口封装为内部接口

4、，并通过将接口的同步处理方式转换为口，并通过将接口的同步处理方式转换为异步处理方式，将请求发送给平台，以便异步处理方式，将请求发送给平台，以便平台进行相应的业务处理平台进行相应的业务处理n 就是一个应用程序，它向外界暴露出一个能够通过进行调用的。这就是就是一个应用程序，它向外界暴露出一个能够通过进行调用的。这就是说，你能够用编程的方法通过来调用这个应用程序。开发工具有、等。说，你能够用编程的方法通过来调用这个应用程序。开发工具有、等。n n 调用远端对象的某个方法调用远端对象的某个方法n 返回该方法运行后的输出结果返回该方法运行后的输出结果User SOAP RequestSOAP Respo

5、nseServiceProviderWebServicen： 由提供（ 在用户的里改。）n： 密码（5加密）n5 加密算法如下：n密码密匙时间戳n 密匙部分由分配，时间戳由发端设备生成；格式为,月日时分秒n： 业务 n：定购参数，群发时不填，单发时必填 业务订购地址，群发时不填；n 付费地址n：的地址n：目的地址，如要发给哪个手机。n：的，也就是发到手机上显示的号码。在用户的表里可以修改。n 里：n：是发多少次；n：容量即发多少条n 时间戳 格式为：格式为,月日时分秒n 业务接入码 可选；n 业务流水号，用户组合业务，可选；n 交易结束标识，用户组合业务，可选;n 事务关联 用户点播业务的事务

6、关联，由平台产生，格式如下为10位随机序列号； 为空 （二进制）表示无效，可选；n ：群发 ：非群发（缺省） 反向调用的密码，可选反向调用的密码，可选 业务接入码业务接入码 业务业务 业务流水号，用于组合业务业务流水号，用于组合业务 事务关联，用于点播业务的事务关联，由平台产生，格式为为事务关联，用于点播业务的事务关联，由平台产生，格式为为10位随机序列号；可选位随机序列号；可选 反向调用名，可选；反向调用名，可选； n 规范介绍规范介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 概述概述n

7、 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍n 业务能力接口定义了短信业务能力集，包括应用端发起的能力集合以及网络侧发起的能力集合。n用户登录短消息门户网站，使用该服务。用户编辑短信，点击发送。门户和 间通过短信，完成短信服务过程。 会将短信中心传送回来的短信状态，通知。用户可以通过门户网站查询得知短信发送的状态，序列图如下：终端用户终端用户门户网站门户网站SAG SMSSAG SMS服务服务登录portal，使用短信功能发送短信请求短信发送标识短信发送状态报告用户查询短信发送状态报告1) 向签约用户发送短消息,业务触发条件由应用提供商与签约用户进行预先约定，参数如下： 目的地址（或

8、地址集合）， 短消息发送者的信息 可选参数。应用于本消息的计费应用可指定计费方案名称，由此确定这条短消息对谁计费以及金额几何 短消息内容 指示是否需要网络侧返回递交状态报告网关根据第三方的要求用 返回状态报告。对本接口的调用，网关应返回,标示该短消息的发送请求。如果消息的长度大于可支持的最大长度，此条消息将被分成若干条连续的短消息进行发送。2) 通过调用，可以查询之前 标识的 发送的状态。状态信息在 参数中返回，它与标识的请求相关的一组状态信息。状态由用户地址和相关的发送状态共同标识。 即使状态达到最终值，这个方法仍可被应用多次调用。然而，状态达到最终值之后，状态信息只在有限的期间内可用，超过

9、该期间，业务接入网关抛出策略异常。其中，返回的状态包括：、等。3) 通过调用，应用可以通过网关获得所有满足 标识准则的短消息。每执行一次该方法，网关将返回给应用的短消息从网关上删除。此外，每条短消息在某个最大时间间隔后，会从服务器上自动删除。这个最大的时间间隔在离线配置阶段定义。接收到的短消息信息在 参数中返回，其中包含短消息的发送者、内容和终端用来发送消息的目标地址。上行接口是由业务接入网关发起的、到业务应用服务器的调用。4) 业务应用服务器先前向网关发送了短消息，如果带有 字段，则当网关获得状态报告时，即调用本接口将短消息的递交状态报告给应用。该状态报告以 和 的组合进行标识。状态信息在

10、中具体描述。5) 业务触发条件由应用提供商与运营商进行预先约定，当业务接入网关收到发给特定地址的短消息时，即调用本接口，将短消息发送给业务应用服务器。 由业务接入网关调用，将短消息的接收通知应用。仅当收到的短消息满足预先约定的提供准则时，网关才会发出通知。这个提供准则由 进行标识。短消息通过标识，包括参数标识短消息的内容，参数，即能被应用监视的短消息的目的地址，参数 包含了发送者地址。应用可采取适当的业务逻辑来处理收到的短消息。上图为应用提交短消息的调用流程：上图为应用提交短消息的调用流程：1-6）提交发送请求给，应答在接入认证完成）提交发送请求给，应答在接入认证完成(10)或向提交或向提交(

11、14)之后返之后返回；回；7-10）通过模块向进行鉴权批价处理，当鉴权失败时，直接进入）通过模块向进行鉴权批价处理，当鉴权失败时，直接进入21通通知鉴权失败；知鉴权失败；11-14）通过模块向提交短消息，返回成功后将信息入库；）通过模块向提交短消息，返回成功后将信息入库；15-18）收到来自的短消息回执；）收到来自的短消息回执；19-22）通过模块向进行鉴权批价确认处理；）通过模块向进行鉴权批价确认处理；23-28）向返回发送状态报告（不要求状态报告时无此流程）。）向返回发送状态报告（不要求状态报告时无此流程）。注：接入认证见后图。注：接入认证见后图。n 规范介绍规范介绍n 业务能力接口介绍业

12、务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍 业务能力接口定义了彩信业务能力集，包括应用端发起的能力集合以及网络侧发起的能力集合。 彩信和短信的流程基本类似，区别在于彩信消息中可以包含图片、文本等附件。用户登录一个卡通图片业务门户网站，为过生日的好友选择祝福卡片，并编辑祝福短信后，点击彩信发送。图片门户与 服务间通过 交互完成彩信的发送。同时， 服务会将彩信中心返回的状态报告通知给图片门户，这样用户可通过门户网站查询彩信发送的状态。下行接口是由业务应

13、用服务器发起、到业务接入网关的调用。1) 业务触发条件由应用提供商与签约用户进行预先约定，由应用根据业务需要在恰当时刻调用本接口，给用户发送一条彩信。本消息调用是请求发送一条彩信到一组地址集合，并返回 对本消息的发送进行标识。网关根据第三方的要求用 返回状态报告，并使用 与先前发送的消息相关联。彩信的内容是作为一个 附件进行发送。第三方通过 告知网关是否需要返回状态报告。2) 通过调用，可以查询之前 标识的 发送的状态。状态信息在 参数中返回，它与标识的请求相关的一组状态信息。状态由用户地址和相关的发送状态共同标识。 即使状态达到最终值，这个方法仍可被应用多次调用。然而，状态达到最终值之后，状

14、态信息只在有限的期间内可用，超过该期间， 业务接入网关抛出策略异常。其中，返回的状态包括：、等。3) 这个操作是使用一个特殊的注册标识符获得一组新的消息。该请求参数为和优先参数（，可选），返回一个数组，其中包括每条彩信的彩信标识、主题、发送方地址、目的地址等。通过该操作，应用可以获取特定标识的彩信基本信息，并依据各个彩信的标识进一步获取彩信地址组及彩信附件。绑定不同注册标识符参数是一个不在线的处理过程。 X 网关不允许使用一个未与应用关联的注册标识符获取消息。4) 这个操作将依据读取消息的不同部分，在业务接入网关建立本地文件并且返回 标识。应用可以仅仅读取每个文件或将其以链接的形式呈现给最终用

15、户。5) 这个操作将依据这个操作将读取整条消息。在返回的消息中，数据以附件形式返回。上行接口是由业务接入网关发起的、到业务应用服务器的调用。6) 业务应用服务器先前向网关发送了彩信，网关对该消息的发送分配了一个标识符。当网关获得状态报告时，即调用本接口将彩信的递交状态报告给应用。本接口的调用是将先前递交彩信的状态报告告知应用，该彩信以 和 的组合进行标识。状态信息在 中具体描述。7) 业务触发条件由应用提供商与运营商进行预先约定，当业务接入网关收到发给特定地址的消息时，即调用本接口，将消息发送给业务应用服务器。当网关收到发送到特定业务激活号码的新消息时，将把消息作为附件通知到应用。参数标识业务

16、激活号码，标识与接收消息相关的所有信息。n 规范介绍规范介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍 业务能力接口定义了定位业务能力集，包括应用端发起的能力集合以及网络侧发起的能力集合。 定位业务能力集可分为一下三类：位置信息同步查询：应用向 查询一个或一组用户位置信息，网关同步返回位置信息告知应用。位置信息异步查询（事件触发）：应用调用一次位置请求，指定范围区域。在查询周期内，用户进入指定区域或离开指定区域，网络将上报用户

17、位置信息。位置信息异步查询（周期性触发）：应用可以调用一个 请求，网络按一定频率周期性上报用户位置信息。 下行接口是由业务应用服务器发起、到业务接入网关的调用。下行接口可分为两类：定位信息同步查询和定位信息异步查询。1) 定位信息同步查询接口，查询一个终端用户的位置信息，参数如下：需定位的终端地址；：要求精度，以米为单位；：可接受的精度，以米为单位。定位结果通过返回给应用，包括经度、纬度以及终端地址等。其中，纬度值以浮点数（-90.0000 +90.0000）形式表示，单位为十进度的度（方向与分钟和秒钟相反），正值表示赤道以北，负值表示赤道以南。经度值以浮点数（-180.0000 +180.0

18、000）形式表示，单位为十进度的度（方向与分钟和秒钟相反），正值表示本初子午线（格林威治）以东，负值表示本初子午线（格林威治）以西，直到第180 条子午线。2) 定位信息同步查询接口， 查询一个与某个特定位置间的距离，该特定的位置以经度和纬度来表示，参数如下：终端地址：指定位置的纬度:指定位置的经度返回终端与指定点间的距离，以米为单位。3) 定位信息同步查询接口，和接口类似，区别在于可以获取一组终端用户的位置信息，参数和一样。定位结果通过数组返回给应用，其中除了包含中的基本信息外，还包括位置报告状态以及错误值（当 为“”时有效）。4) 定位信息异步查询接口（事件触发），用于请求 以一定原则上报

19、一个或多个终端的位置信息。报告上报的原则为用户进入或离开指定的区域。该请求的参数包括终端地址组、原点的经纬度、范围的半径、产生报告的原则、是否立即查询、上报最大频度、最大时长以及上报次数等。业务接入网关收到该请求后，通过按照应用的要求上报终端位置信息，错误信息通过上报应用，上报结束时调用通知应用。5) 定位信息异步查询接口（周期性触发），用于请求 按照一定的精度周期性上报一个或多个终端的位置信息。该接口和区域定位类似，也是通过等接口通知应用定位结果。6) 请求 停止周期性或事件触发性的上报一个或多个用户的状态信息。周期性及事件触发性定位请求中将该请求的异步位置查询的请求标识（）带给业务接入网关

20、，应用通过该标识通知停止上报。上行接口是由业务接入网关发起的、到业务应用服务器的调用。7) 该接口用于业务接入网关向应用返回需要查询的终端用户位置信息。该通知消息通过参数和应用下发的周期性或事件触发异步位置查询请求相关联，位置信息放在数组中，当请求是事件触发的异步位置查询请求时，通过参数指明当前位置上报的原则。8) 该接口用于业务接入网关查询用户位置消息出现错误时，通知业务应用服务器。该通知消息通过参数和应用下发的周期性或事件触发异步位置查询请求相关联，参数指明错误报告对应的终端地址，指明错误原因。9) 当位置报告的最大时长或者次数到时，则 结束周期性监视状态。接口通过参数和应用下发的周期性或

21、事件触发异步位置查询请求相关联。n 规范介绍规范介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍 业务能力接口定义了业务能力集，包括应用端发起的能力集合以及网络侧发起的能力集合。 和短信的流程基本类似，基本业务流程如下：应用程序向业务接入网关提交推送请求，业务网关返回请求标识。应用程序可以根据返回的请求标识主动向业务接入网关查询状态，也可以等待业务接入网关发出推送结果通知。下行接口是由业务应用服务器发起、到业务接入网关的调用。1

22、) 本操作请求把一个消息的 地址推送到一组目标地址，并且返回一个请求标识（）以唯一标识这个消息。应用程序可以稍后用 查询消息状态。第三方通过 告知网关是否需要返回状态报告。网关根据第三方的要求用 返回状态报告，并使用 与先前发送的消息相关联。2) 通过调用，可以查询之前 标识的推送请求的处理状态。状态信息在 参数中返回，它与标识的请求相关的一组状态信息。状态由用户地址和相关的发送状态共同标识。 即使状态达到最终值，这个方法仍可被应用多次调用。然而，状态达到最终值之后，状态信息只在有限的期间内可用，超过该期间， 业务接入网关抛出策略异常。其中，返回的状态包括：、等。上行接口是由业务接入网关发起的

23、、到业务应用服务器的调用。3) 本操作向客户端应用程序通知推送结果。本接口的调用是将先前递交的推送请求的状态报告告知应用，该短消息以 和 的组合进行标识。状态信息在 中具体描述。n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力介绍业务能力介绍n 业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍 业务能力接口定义了语音呼叫业务能力集，该业务能力集只有应用端发起到业务接入网关调用的能力集合。 提供

24、了一种灵活的方式来传递语音信息。接口非常简单，不需要开发者去管理呼叫的产生，也不需要与呼叫交互来发送语音消息。 有三种机制可以用于语音消息的内容：文本：使用（）引擎来播放语音内容（例如，）：使用放音设备来播放：使用 浏览器来播放 目前只支持文本放音。 应用调用接口请求放音，网关返回请求标识，应用根据该关联标识查询呼叫状态，同时应用也可以根据该关联标识取消放音服务。1) 调用该接口用于创建一个到用户的呼叫，该用户由标识，并且播放位于 的 文件信息。当系统接收到请求后，调用会立即返回结果（实际的呼叫异步进行）。返回值将被用来标识这次请求。这个操作被用来对单个终端播放一条信息。这里提供的应该是单个终

25、端，而不是群组。如果提供了群组，则应用将收到。、和该接口类似，只是播放的语音内容不同。2) 调用 来得到先前请求的当前状态。先前请求由 来标识，得到值，指明当前播放状态为已播放、正在播放、还未播放或是发生错误。3) 调用 取消或停止由 标识的先前请求。返回值为，包含了在放弃请求时刻的状态。n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力介绍业务能力介绍n 业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下

26、行接口介绍 业务能力接口定义了第三方呼叫业务能力集，该业务能力集只有应用端发起到业务接入网关调用的能力集合。 描述第三方呼叫，用于创建并管理应用发起的呼叫。此 的范围就是以简单的方式为应用开发商提供创建呼叫的功能。事实上，通过使用这个第三方呼叫 ，应用开发商不需要掌握详细的电信知识，就能调用呼叫处理功能。 基本流程： 业务门户提供用户点击拨号的业务界面，用户只需通过点击网页就可以建立语音呼叫。业务网关会在业务请求收到后返回一个能唯一标识该次呼叫的参数。用户也可以通过业务界面停止该呼叫。1) 第三方触发一语音增值业务，通过 指示网关发起业务呼叫。网关呼通主叫，再连接被叫。作为可选，应用还可以提供

27、计费（）指示。返回的参数（）用于标识此呼叫， 可以用它来监视这个呼叫的状态，或是取消呼叫等。2) 调用 获得指定呼叫（由 标识）的当前状态。呼叫结束后，在静态配置的有效期内，网关将保存呼叫状态，以供查询。返回的状态信息包括呼叫状态、开始时间、时长等。3) 通过呼叫标识指示网关结束 呼叫。如果呼叫还处于初始阶段，网关将放弃呼叫。如果呼叫已经建立，网关将切断呼叫。4) 通过呼叫标识指示网关放弃 呼叫。如果呼叫还未建立，指示网关放弃 呼叫，如果呼叫已经建立，呼叫将不受影响。n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍

28、业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力介绍业务能力介绍n 业务能力接口介绍业务能力接口介绍n 概述概述n 上行接口介绍上行接口介绍 业务能力接口定义了网络发起到第三方呼叫的业务能力集， 用于处理网络中的签约用户发起的呼叫，一个第三方的应用将决定此呼叫将如何处理。 基本是一个被叫属性触发的业务能力集，包括两类接口，四种触发方式：接口可分为两类和：两类接口都是依照事先配置的事件触发呼叫，不同的是接口是网关用来通知 ，而中定义的接口网关不但将呼叫通知，并等待 的下一步动作指示。触发方式包括：被叫忙触发、被叫不可达触发、被叫无应答触发和接入

29、码触发。1) 类接口类接口包括四个：、，这四个接口的参数及返回值类型一致，只是触发方式不同。在此以为例说明。在一个基本呼叫中，当被叫忙时，触发智能业务。网关向 进行智能请求， 进行相关业务判断，指示网关进行动作。 指示网关动作有三种： ： 正常地处理网络中的被叫忙事件 ： 结束呼叫 ： 重新路由到应用指定的目标地址 当应用指示的网关动作是时，返回的中还包含重新路由的地址。2) 类接口类接口包括四个：、，这四个接口的参数类型一致，只是触发方式不同。在此以为例说明。在一个基本呼叫中，当被叫忙时，触发智能业务，网关将被叫忙事件通知给。该类请求的参数和类接口类似，包括主叫号码、被叫号码以及主叫方名称（

30、可选）， 类接口没有返回值。n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力介绍业务能力介绍n 业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍 ，即，增强呼叫业务集，分为应用侧发起的呼叫和网络侧发起的呼叫。 在 和 中描述的呼叫控制，无论是第三方发起的还是网络发起的，应用和网络的交互都是一次性的。在呼叫建立后，应用无法对呼叫的进展保持跟踪，因而也不能根据呼叫的具体

31、进展情况作进一步的处理；同时，应用也无法利用网络专有资源向用户提供服务。这在很大程度上限制了应用开发商开发业务的灵活性和多样性。增强型呼叫控制，以简单的方式为应用开发商提供持续控制一个呼叫的功能。 下行接口即类接口，应用侧发起的呼叫，是由 到业务应用服务器的调用。第三方可以发起一个呼叫，也可以根据呼叫标识查询呼叫状态或结束呼叫。1) 第三方触发一语音增值业务，通过 指示网关发起业务呼叫，并返回呼叫标识。请求参数：(主叫号码)、 （指示网关的处理动作）、（计费标识）、（是否抑止）;响应消息携带呼叫标识；用户点击网页触发语音增值业务，启动业务逻辑，指示网关先呼通主叫，主叫摘机应答后，网关按照的指示

32、处理呼叫。若 的指示为用户交互时，网关处理结束后必须上报；若 的指示为呼叫时， 应指明网关是否需要上报呼叫处理结果。n 指示主叫摘机应答后，网关的处理动作：n 与用户语音交互n 连接一个指定的被叫n 失败后，无条件顺呼n 同振n2) n第三方根据已建立呼叫的呼叫标识调用 来指示网关中断终端正在进行的行为（放音、通话），开始一个新的处理动作， 为新的处理动作的指示。被中断的终端为已被连接至系统的终端。3) 业务触发条件： 业务已触发，并得到了呼叫标识 。应用：应用调用 查询业务是否还正常进行，实现与 之间的激活测试机制。4) 业务触发条件： 业务已触发，并得到了呼叫标识 。应用：根据呼叫标识调用

33、指示网关切断呼叫，结束业务呼叫服务。 上行接口即类接口，网络侧发起的呼叫，是由 到业务应用服务器的调用。 生成呼叫标识， 根据该标识指示 进行放音、呼叫接续、同振、顺呼、彩铃等动作。1) 用户通过拨打业务接入码方式进行业务触发， 将业务请求通知。 收到业务请求，启动业务应用（），开始增值业务服务。网关将呼叫信息（主、被叫）和业务触发原因上报给。 通过业务逻辑判断，指示网关如何处理当前呼叫。若处理的动作为用户交互时，网关处理结束后必须上报；若处理的动作为呼叫时， 需要指示网关上报呼叫处理结果，否则网关不上报。网关通知 业务请求时，呼叫的状态为： 被叫忙 被叫不可达 被叫无应答 主叫摘机 业务接入

34、码呼叫 呼叫流程触发情况 呼叫流程触发情况 指示网关的处理动作为： 结束呼叫 与用户语音交互 连接一个指定的被叫 失败后，无条件顺呼 同振2) 业务触发条件：当网关根据应用指示对业务请求的处理动作为呼叫时，如：呼一个被叫、同振、顺呼，并且 指示网关呼叫处理结束后上报呼叫处理结果。网关呼叫处理结束，通过 上报呼叫处理结果。 收到呼叫处理结果，进行业务判断，指示网关下一步的处理动作，下一步动作和中的返回值一致，网关通知 呼叫处理结果分以下几种： 呼叫失败：被叫忙 呼叫失败：被叫不可达 呼叫失败：被叫无应答 呼叫失败： 终端离线 呼叫完成：被叫挂机 呼叫完成：呼叫限制到3) 业务触发条件：当网关根据

35、应用指示对业务请求的处理为进行用户交互时，如：向用户播放语音、放音收号、取 脚本进行用户交互。用户交互结束后，网关通过 上报用户交互结果。 根据网关上报的用户交互结果进行业务判断，指示网关下一步的处理动作。 下一步动作和中的返回值一致，网关通知 用户交互结果如下： 用户交互结束，无收号 用户交互结束，有收号 号码 用户交互失败 4) 网关将被叫应答、主叫挂机等呼叫事件以通知的方式告知。通知的事件包括以下几种： 被叫应答主叫挂机主叫忙主叫无应答主叫不可达各个呼叫控制步骤通过上行接口参数中的呼叫标识相互关联。n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介

36、绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力介绍业务能力介绍n 业务能力接口介绍业务能力接口介绍n 概述概述n 下行接口介绍下行接口介绍n 上行接口介绍上行接口介绍n ：即（ ）；即非结构化补充数据业务。是一种基于网络，可以提供综合性、交互式信息服务的数据业务! n与短消息业务（）都是通过网络的信令通道传递的。不同之处在于短消息属于存储转发方式，则属于面向对话方式。当用户访问业务时，该对话通路保持连接，直到对话结束。n 用于在应用和用户之间的建立的交互，以此完成一些信息的交互。n下行接口类包括如下接口

37、类：n n上行接口类包括如下接口类：n n接口类接口类1 1 nn由应用发起的请求，将信息传递给网关由应用发起的请求，将信息传递给网关; ;应用调用本接口，向网关发起交互请求。应用调用本接口，向网关发起交互请求。 n交互的内容中描述。该消息的目的地址交互的内容中描述。该消息的目的地址由描述。由描述。n应用的请求网关返回应用的请求网关返回, ,以使本次交互与后以使本次交互与后续的交互关联起来。续的交互关联起来。n方法有和方法有和: : n接口类接口类2 2： n1 1n网关调用本接口，向应用发起交互请求网关调用本接口，向应用发起交互请求及消息内容。网关通过标识这次特定的及消息内容。网关通过标识这

38、次特定的交互。交互的内容在中描述。请求的发交互。交互的内容在中描述。请求的发起者由描述。网关通过请求应用给出下起者由描述。网关通过请求应用给出下一步的交互的信息。一步的交互的信息。n2n在交互已成功建立之时，网关调用本在交互已成功建立之时，网关调用本接口，将用户的反馈信息告知应用。网接口，将用户的反馈信息告知应用。网关通过标识这次的特定的交互。交互的关通过标识这次的特定的交互。交互的内容在中描述。请求的发起者由描述。内容在中描述。请求的发起者由描述。网关通过请求应用给出下一步交互信息。网关通过请求应用给出下一步交互信息。n3. n网关调用本接口告知应用交互被中止，网关调用本接口告知应用交互被中

39、止，并在参数中给出中止原因。网关通过标识并在参数中给出中止原因。网关通过标识这次特定的交互。这次特定的交互。n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力介绍业务能力介绍n 业务能力接口介绍业务能力接口介绍n概述n下行接口介绍n上行接口介绍业务：即 终端状态业务。 查询终端状态和终端状态报告。n业务下行接口类即类接口，调用该接口查询一个终端用户的当前状态信息。n1. n调用，获取终端地址列表信息，返回 中的参数类型

40、为终端状态列表信息。n2. n通过本操作 请求周期性的上报一个或者多个用户的状态信息，并返回对本请求的进行标识。n其中方法中包括如下参数：n参数： 监听异步请求返回值，接收用户的状态的地址信息。n参数： 需要获取的用户状态的终端地址数组n参数： 指定报告的一些状态，用于所有终端；n参数： 是否立即检查状态标识n参数： 状态通知的最大频率 ，报告间隔的最小时间n参数： 报告时长。若则使用 中的默认值n参数： 报告次数的上限，“0”为无限制n输出：n3. n请求停止周期性的上报一个或者多个用户的状态信息。n接口类接口类 n1 1n通过本操作通过本操作 业务接入网关向应用返回业务接入网关向应用返回n

41、需要查询的用户状态信息。需要查询的用户状态信息。n2 2 n通过本操作智能业务接入网关查询用户状态消息时，出通过本操作智能业务接入网关查询用户状态消息时，出现的错误现的错误, ,通知业务应用服务器。通知业务应用服务器。n3 3n通过操作通过操作 ，当状态报告的最大时长或者次数限制到时，当状态报告的最大时长或者次数限制到时，则结束周期性的监视状态。则结束周期性的监视状态。n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力

42、介绍业务能力介绍n 业务能力接口介绍业务能力接口介绍n概述n下行接口介绍n上行接口介绍n本服务用于实现符合中国电信的结构体和标准的支付能力。n通过使用本业务能力接口，可以在用户的银行、虚拟的通讯帐户上扣除因用户使用服务，或者购买商品而产生的费用。同时，为适用中国电信现状，本业务能力接口还增加了对用户直接从电信统一门户或者门户购买的商品的方式的支持，以及对派奖活动的支持。n注意：n本接口参考原2.0规范中的部分的内容，但是与其不兼容。若要兼容2.0 规范需对本接口进行扩展。1.支付接口类：支付接口类：该接口用于用户购买商品或服务后，从用户帐户中扣除因该接口用于用户购买商品或服务后，从用户帐户中扣

43、除因商品交易或服务交易而发生的费用，以及对派奖活动的商品交易或服务交易而发生的费用，以及对派奖活动的支持。支持。包括包括4个操作：个操作：1.支付请求；支付请求；2.支付确认；支付确认；3.冲正；冲正；4.派奖派奖针对每个操作分别为：针对每个操作分别为：向请求扣费；：向请求扣费；： 通知扣费完成；通知扣费完成；： 发现问题后，对原来的成功的交易进行冲正；发现问题后，对原来的成功的交易进行冲正；： 向用户的帐户中充入奖励给用户的金额；向用户的帐户中充入奖励给用户的金额；2.2.通知接口：通知接口：该接口用于向发起通知类信息。包括该接口用于向发起通知类信息。包括2 2个：和。个：和。操作方法包括：

44、操作方法包括：1.1.购买通知购买通知该操作主要用于向通报：用户已经从电信统一接入门户上该操作主要用于向通报：用户已经从电信统一接入门户上订购了他们公司的产品或服务。订购了他们公司的产品或服务。2.2.支付通知支付通知该操作主要用于向通报：用户预授权，可以进行业务处理。该操作主要用于向通报：用户预授权，可以进行业务处理。包括通知的包括通知的 已经对用户预授权成功。已经对用户预授权成功。n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口

45、介绍n 业务能力接口介绍业务能力接口介绍n 业务能力接口介绍业务能力接口介绍n概述n业务能力接口介绍（1）n业务能力接口介绍（2）n业务能力接口介绍（3）n业务能力接口介绍（4）n用于向用户提供呈现信息，并将这些呈现的信息提供给订阅这些信息的用户。业务允许呈现信息被一个或更多的用户获取，同样也允许注册呈现信息。这些接口的典型的客户端可以是呈现信息的提供者，也可以是呈现信息的使用者n序列图n如 订阅呈现信息序列图n观察者应用向业务接入网关发送订阅请求。业务接入网关通知服务器，等n服务器得到确认消息后，业务接入网关将订阅结果返回给观察者应用。n接口类接口类n使用本接口的客户端的角色是观察者。该接口

46、使用本接口的客户端的角色是观察者。该接口类只包含一个，即，是业务能力的基本操作。类只包含一个，即，是业务能力的基本操作。n用来在服务器上注册用户，只有用户在注册之用来在服务器上注册用户，只有用户在注册之后，用户才能使用消息订阅呈现者信息或者使后，用户才能使用消息订阅呈现者信息或者使用消息发布自身信息。用消息发布自身信息。n参数：（注册用户，即观察者），（保持注册参数：（注册用户，即观察者），（保持注册的存活时间，的存活时间，0表示注销）表示注销）n响应消息：（注册结果，响应消息：（注册结果，:成功或成功或:失败）、（注失败）、（注册状态的超期时间）册状态的超期时间）n接口类接口类n使用本接口的

47、客户端的角色是观察者。观察者使用本接口的客户端的角色是观察者。观察者使用的本类的接口集合来获取呈现的数据。再使用的本类的接口集合来获取呈现的数据。再订阅呈现数据后，观察者可在选择轮询或通知订阅呈现数据后，观察者可在选择轮询或通知的模式来接收呈现数据。该接口类属于下行接的模式来接收呈现数据。该接口类属于下行接口。口。n该接口类包含四个：该接口类包含四个：n1) : 订阅呈现信息订阅呈现信息n2) : 获取呈现信息获取呈现信息(暂不实现暂不实现)n3) : 通知模式请求呈现信息通知模式请求呈现信息(暂不实现暂不实现)n4) : 主动停止呈现信息通知主动停止呈现信息通知(暂不实现暂不实现)n1n本接

48、口用来调用用户的呈现信息。假设观察者之前已经本接口用来调用用户的呈现信息。假设观察者之前已经被鉴权，因此其标识为可识别的，能与服务器总的签约被鉴权，因此其标识为可识别的，能与服务器总的签约信息关联。调用该方法，将联系被呈现的用户，并请求信息关联。调用该方法，将联系被呈现的用户，并请求他授权给观察者。由于这个过程涉及到用户交互，因此他授权给观察者。由于这个过程涉及到用户交互，因此不会马上就有响应。将使用的不会马上就有响应。将使用的()来通知观察者。来通知观察者。n如果被呈现的用户是一个组，这要联系组中的每一个成如果被呈现的用户是一个组，这要联系组中的每一个成员，要求他们授权，对每个成员，观察者都

49、要得到一个员，要求他们授权，对每个成员，观察者都要得到一个通知，仅在订阅完成后且被呈现的用户允许对其属性进通知，仅在订阅完成后且被呈现的用户允许对其属性进行接入后，观察者才能在使用行接入后，观察者才能在使用()或者或者()之后获取信息。之后获取信息。 n参数说明参数说明:n请求消息参数：请求消息参数：表示一个空的数组表示所有属性。描述用户需要这些数表示一个空的数组表示所有属性。描述用户需要这些数据是为了哪个应用而定。据是为了哪个应用而定。 包含了在通知接口之后的消息中使用的关联符。在这个包含了在通知接口之后的消息中使用的关联符。在这个接口的级别上，订阅是不过期的，尽管它可以呈现用户接口的级别上，订阅是不过期的，尽管它可以呈现用户的底层被结束，请参考方法，参数用于标识应用是否取的底层被结束，请参考方法，参数用于标识应用是否取消对状态的订阅；消对状态的订阅；n响应消息返回订阅状态的超期时间；响应消息返回订阅状态的超期时间；n接口类：接口类：n 该接口类的接口都属于上行接口（即回调该接口类的接口都属于上行接口（即回调的接口），呈现使用者通过这些接口将相关信的接口），呈现使用者通过这些接口将相关信息通知给；其响应结构体都是空的。息通知给；其响应结构体都是空的。包括四个：