中国移动Widget业务平台接口规范

《中国移动Widget业务平台接口规范》由会员分享，可在线阅读，更多相关《中国移动Widget业务平台接口规范（78页珍藏版）》请在装配图网上搜索。

1、 QB-中国移动通信企业标准QB-Widget业务平台接口规范Interface Specification For Widget Service Platform版本号：1.0.0-实施-发布中国移动通信集团公司 发布I QB-目 录前 言IV1范围12规范性引用文件13术语、定义和缩略语13.1术语、定义13.2缩略语14网络结构24.1网元功能描述34.2接口描述45接口定义55.1接口命名规范55.2接口字段类型说明55.3IF-WGA（Widget业务平台Widget应用）55.3.1功能描述55.3.2代理访问接口65.3.2.1请求参数说明65.3.2.2返回值说明65.3.3查

2、询订购接口115.3.4业务退订接口125.3.5应用版本查询接口135.4IF-EGN（Widget业务平台Widget引擎）145.4.1引擎版本查询接口145.4.2安全验证接口155.4.2.1业务订购通过定制引擎完成的流程165.4.2.2业务订购通过非定制引擎完成的流程185.4.3运营商网络侧能力访问接口205.4.3.1查询自己的位置205.4.3.2查询他人的位置225.4.3.3设置自身的位置255.4.4测量数据上传接口275.5IF-WGS（Widget业务平台Widget服务代理）285.5.1功能描述285.5.2接口内容描述285.6Widget下载器接口285.

3、6.1取得Widget分类信息305.6.1.1业务流程305.6.1.2接口设计305.6.2取得Widget分类中的Widget应用版本列表325.6.2.1业务流程325.6.2.2接口设计325.6.3取得平台推荐的Widget应用版本列表365.6.3.1业务流程365.6.3.2接口设计365.6.4搜索Widget应用版本395.6.4.1业务流程395.6.4.2接口设计395.6.5资源文件下载435.6.5.1业务流程435.6.5.2接口设计435.6.6取得恶意Widget列表455.6.6.1业务流程455.6.6.2接口设计455.6.7评价widget465.6.

4、7.1业务流程465.6.7.2接口设计465.6.8查询Widget评价475.6.8.1业务流程475.6.8.2接口设计485.6.9下载鉴权接口505.6.9.1业务流程505.6.9.2接口设计505.6.10下载确认接口525.6.10.1业务流程525.6.10.2接口设计525.6.11Widget应用版本文件下载535.6.11.1业务流程535.6.11.2接口设计535.6.12Widget引擎版本查询接口545.6.12.1业务流程545.6.12.2接口设计545.6.13取得Widget应用版本详细信息555.6.13.1业务流程555.6.13.2接口设计555.

5、6.14资源文件下载585.6.14.1业务流程585.6.14.2接口设计585.6.15Widget应用版本文件下载605.6.15.1业务流程605.6.15.2接口设计605.6.16取得恶意Widget列表615.6.16.1业务流程615.6.16.2接口设计615.6.17评价widget625.6.17.1业务流程625.6.17.2接口设计625.6.18查询Widget评价635.6.18.1业务流程635.6.18.2接口设计645.7IF-SIMS（Widget业务平台SIMS）665.7.1SP信息同步665.7.1.1业务流程665.7.1.2接口设计665.7.2

6、业务同步685.7.2.1业务流程685.7.2.2接口设计685.8IF-WAPGW（Widget业务平台WAP网关）705.8.1功能描述705.8.2接口内容描述705.9IF-OAM（Widget业务平台网管系统）715.10IF-DSMP（Widget业务平台DSMP）715.11IF-BOSS（Widget业务平台BOSS）715.12IF-VGOP综合网关（Widget业务平台VGOP）715.13IF-MM（Widget业务平台M-Market平台）716编制历史71附录A 错误编码72III前 言本标准规定了Widget业务平台与相关网元的接口，及接口实现要求，是中国移动Wi

7、dget业务平台规划和建设的基本依据。本标准主要包括以下几方面内容：Widget业务平台的网络结构及接口描述，Widget业务平台与各相关网元设备之间的详细接口定义等内容。本标准是Widget业务系列标准之一，该系列标准的结构、名称或预计的名称如下：序号标准编号标准名称1Widget业务平台总体技术要求2Widget业务平台业务规范3Widget业务平台设备规范本标准需与Widget业务平台业务规范配套使用。本标准的附录A为标准性附录，附录为资料性附录。本标准由中移号文件印发。本标准由中国移动通信集团数据部提出，集团公司技术部归口。本标准起草单位：中国移动通信有限公司研究院。本标准主要起草人：

8、IV1 范围本标准规定了Widget业务平台与外部网元之间的接口，供中国移动通信集团内部和厂商共同使用，用于在设备开发和运行维护上为集团公司和省公司提供技术依据，可作为Widget业务平台设备测试标准制定和后续业务开发的依据。2 规范性引用文件下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。1Widget业务平台总体技术要求中国移动通信有限公司2Widget业务平台设备规范中国移动通信有限公司3

9、Widget业务平台业务规范中国移动通信有限公司3 术语、定义和缩略语3.1 术语、定义术语/定义解释Widget应用Widget是一种运行在用户终端上的轻量级web应用程序Widget业务Widget业务是基于Widget应用进行展示的数据业务Widget引擎Widget引擎是Widget应用的基础运行环境Widget管理器Widget管理器是用来管理移动终端上内置或已通过Widget下载器/WWW/WAP方式下载的Widget应用的客户端软件，具备安装、卸载、搜索本地Widget应用、设置等功能Widget下载器Widget下载器是用来浏览和下载Widget应用的客户端软件 3.2 缩略语

10、缩略语英文全称中文含义OTAOver The Air 空中、无线方式 WAPWireless Application Protocol 无线应用协议 APApplication Provider 应用提供商 SPService Provider 服务提供商 CPContent Provider 内容提供商 GPRSGeneral Packet Radio Service, 通用无线分组业务 TD-SCDMATime Division-Synchronous CDMA 时分同步码分多址接入 EDGEEnhanced Data rates for GSM Evolution GSM增强数据速率改进

11、技术 WWWWorld Wide Web 万维网 HTTPHyperText Transfer Protocol 超文本传输协议 FTPFile Transfer Protocol 文件传送协议 APIApplication Programming Interface 应用程序接口 SMSShort Message Service 短消息服务 BOSSBusiness Operation Support System 业务运营支撑系统 URLUniform Resource Locator 统一资源定位 MMSCMultimedia Messaging Service Center 彩信中心

12、SNMPSimple Network Management Protocol 简单网络管理协议 DRMDigital Rights Management 数字版权管理 JILJoint Innovation Lab联合创新实验室SIMSService Information Management System业务信息管理系统LBSLocation Based Service基于位置的业务LSPLocation Service Platfor位置业务平台VGOPValue-added Service General Operation Platform增值业务综合运营平台MMMobile Mar

13、ketM-Market业务平台WGAWidget ApplicationWidget应用WGSWidget ServerWidget应用服务器4 网络结构Widget业务平台涉及的接口如下： 图4-1 Widget业务平台逻辑功能模块图4.1 网元功能描述Widget业务平台包括如下子系统：l 门户展示子系统：包括WAP、WWW和Widget下载器，主要实现Widget应用的展示、营销、自服务、推广功能。l 访问控制子系统：Widget业务平台的核心子系统，提供下载控制、代理访问、业务鉴权及计费功能、还实现对网络资源能力代理的功能。 下载控制模块：用于控制Widget应用的下载过程，同时对下载

14、实现计费控制； 代理访问模块：用于代理Widget应用在线业务内容访问功能； 业务鉴权订购模块：用于Widget应用在线业务鉴权、订购的控制功能； 计费模块：用于实现Widget下载和在线内容使用的计费控制； 版本升级控制模块：用于控制Widget应用和Widget引擎的版本升级功能； 网络资源能力代理模块：用于代理Widget应用使用移动网络资源能力；l 后台管理子系统：包括面向运营管理人员的合作管理、业务管理、应用管理等模块，以及终端适配管理模块、系统日志、监控、告警等模块 合作管理模块：主要实现SP、开发者的合作管理，以便为平台提供Widget应用 Widget应用管理模块：用于Widg

15、et应用接入管理功能； 业务管理模块：用于Widget应用相关业务接入管理功能； 内容托管模块：用于部分Widget应用在线内容托管功能； 终端适配管理：用于管理终端库及终端属性； 系统管理模块：用于系统用户、权限等管理功能；l 运营分析子系统：用于Widget业务平台运营数据统计，为业务运营分析提供支撑。其他网元包括：l Widget服务代理：Widget服务代理可以代理Widget访问内容源业务内容。l WAP网关：用户通过WAP 网关访问WAP门户，并且WAP网关在转发用户请求到Widget业务平台时，HTTP请求中必须有一些参数，以保证Widget业务流程能够正常处理。l 网管系统：对

16、 Widget业务平台行设备管理和监控。l VGOP综合网关：Widget业务平台与其他业务平台实现业务互通设置和设置信息同步，以及平台业务能力调用时需要通过VGOP综合网关。l DSMP：主要完成对Widget业务的鉴权、订购、以及部分计费功能。l BOSS：实现对独立类Widget业务的支持如业务信息、订购关系、话单；实现对捆绑类Widget业务增加Widget通道、保存订购关系及话单等功能。l SIMS系统：实现SP信息及业务信息同步的功能。l MM平台：Widget业务平台输出Widget应用到M-Market平台，实现共享资源、门户整合、业务整合。（可选）4.2 接口描述Widget

17、业务平台主要包括以下几类接口： IF-WGA：Widget业务平台与Widget应用接口，通信以及接口参数定义； IF-EGN：Widget业务平台与Widget引擎之间的接口，主要是订购、计费流程中实现安全的接口； IF-WAPGW：Widget业务平台与WAP网关之间的接口； IF-WGS：Widget业务平台与业务服务端之间的接口，主要是代理访问业务内容的接口； IF-OAM：Widget业务平台与综合网管之间的接口，按照网管规范实现网管接口； IF-DSMP：Widget业务平台与DSMP之间的接口，主要实现业务鉴权、订购、以及部分计费功能； IF-BOSS：Widget业务平台与BO

18、SS之间的接口，主要是计费、结算等与话单相关的接口； IF-SIMS：Widget业务平台与SIMS之间的接口，主要是Widget业务平台相关业务数据的交互、同步功能接口。 IF-MM：Widget业务平台与M-Market平台共享资源、门户整合、业务整合时需要定义此接口，（可选）。 IF-VGOP综合网关：Widget业务平台与VGOP平台的接口，VGOP平台中的业务需要接入Widget业务平台时需要使用此接口（可选）。5 接口定义5.1 接口命名规范接口名称采用单词首字母大写，其他字母小写的方式。缩略语中的字母都大写。消息内容定义中，基本数据类型的字段命名规范采用单词首字母大写，单词间没有

19、连接符的方式。5.2 接口字段类型说明integer：十进制的整数型。unsigned integer：十进制的无符号整数型。string：由char组成的字符串binary：由byte组成的字符串，由于XML不能直接承载二进制数据，所以对该类型的数据采用BASE64编码。5.3 IF-WGA（Widget业务平台Widget应用）5.3.1 功能描述Widget应用使用业务时，需要通过Widget应用支撑平台代理访问，以便控制业务的使用过程，本节即定义访问代理的接口要求。接口的主要功能是代理访问业务内容。Widget业务平台必须获取用户的手机号码作为用户标识，所以手机终端上Widget应用接

20、入无线网络时，必须使用cmwap，同时Widget业务平台的主机地址（域名或IP）需要加入WAP网关的白名单中，以便手机号码和User-Agent参数能够送到Widget业务平台。基于上面的原因，由于无法从请求中获取手机号码和User-Agent，Widget业务平台暂不处理通过cmnet访问的请求。5.3.2 代理访问接口功能：代理访问业务内容通信方式：HTTPXML/文本/二进制内容提供方：Widget业务平台使用方：widget应用HTTP地址：http:/host:port/pull;sid=xxxx?wvid=111&u=/path/content（示例）5.3.2.1 请求参数说明

21、 URL参数说明：n sid：session id。如果Widget应用可以通过cookie上传session id，上面的URL地址中就不需要“;sid=xxxx”这种参数。n wvid：Widget版本代码，唯一标识widget应用版本，根据wvid可以查到对应的业务。n u：参数位于URL最后面，业务内容的URL地址，需要对参数值进行encode。SSP获取u参数的值后，判断该值是否是完整的URL地址，如果不是，SSP根据wvid参数值查询该widget的服务端地址前缀（包括主机和端口，格式为http:/host:port），再与u参数值拼接成完整的URL地址（拼接时注意判断”/”个数）

22、，完成后续的代理请求。如果u参数值是完整的URL地址，则不增加前缀。5.3.2.2 返回值说明HTTP响应包体为XML/文本，XML/文本包体内容由widget应用对应的widget服务器返回，widget访问代理透传该内容给widget应用。同时返回的HTTP包头中包含session信息，下次请求时需要携带该session标识，以保证会话不丢失。n 为了方便Widget应用取到系统sessionID值，Widget业务代理在返回包包头中增加下面的内容：x-widget-sid: sid值sid值为SessionID。n 针对移动资费提示页面（即主页推送）系统的影响，为了便于Widget应用判

23、断数据确实来自Widget业务代理，Widget业务代理返回包包头中需要增加下面的内容：x-content-source: widget_ssp前面为key，后面为value。注意SSP响应给Widget应用的所有数据包，包括Widget下载列表、SSPResp消息、代理Widget服务代理的内容等（WAP访问的返回内容除外），都需要在包头中增加这个标识内容。Widget应用只有从HTTP Header中取到这个标识值才表述数据来自Widget访问代理。n 响应数据包类型标识为了便于手机客户端上Widget引擎和Widget应用处理不同类型的消息包，Widget业务平台响应值的HTTP包头中增

24、加类型标识：x-widget-msg-type: type值不传x-widget-msg-type参数或参数值为空时，缺省值为业务内容数据包，Widget应用根据业务要求展示数据内容，如果异常时传此参数。type值：1异常/错误返回，需要显示错误信息给用户2业务资费信息返回，需要提升用户资费信息3重定向返回，Widget应用自动请求重定向地址的内容下述章节对type值分别详细说明。5.3.2.2.1 正常返回Widget服务代理正常返回时，Widget业务平台把业务内容直接返回给Widget应用，对内容不做修改。下面是天气预报应用服务端返回的内容，直接透传给Widget应用：（示例数据） 0

25、操作成功北京110452200806062616b0晴微风弱优较弱不宜炎热一般无较不宜2818b12515b05.3.2.2.2 异常/错误返回对于Widget应用与访问代理交互过程中，如果请求没有携带手机号码或者访问代理内部错误，需要响应错误给Widget应用，业务流程终止，返回消息为：SSPResp，对应x-widget-msg-type取值为1。XML格式序号父元素名称元素名称描述SSPRespSSPRespVersion平台版本，填固定值1.0.0SSPRespMsgType消息类型，填1SSPRespReturnValue取值：1：系统错误2：无法取到手机号码3：业务服务端链接失败、

26、超时等4：号码不是中国移动的号码5：业务订购时，时间戳超时6：业务订购失败7：请求参数错误或缺失8：用户不能使用应用，超出业务开放范围限制12：图形码验证失败13：定制引擎摘要信息验证失败SSPRespReturnInfo错误信息说明样例：1.0.01 1 系统错误Widget应用需要根据实际情况提示用户。比如返回2时，Widget应用需要提示“无线接入请使用cmwap”之类的信息。5.3.2.2.3 业务资费信息返回当用户没有订购业务时，SSP响应包中必须包含业务相关的信息，便于Widget应用或引擎提示用户进行订购，返回消息为：SSPResp，对应x-widget-msg-type取值为2

27、。XML格式序号父元素名称元素名称描述SSPRespSSPRespVersion平台版本，填固定值1.0.0SSPRespMsgType消息类型，填2SSPRespReturnValue取值：9：按次业务需要提示用户资费115：用户没有订购业务SSPRespReturnInfo错误信息说明SSPRespServiceInfo仅两种情况需要本业务信息节点： ReturnValue为115时，即当前为包月业务用户没有订购，访问到计费内容。 ReturnValue为9时，即当前为按次业务，不管用户是否已订购，只要访问到计费内容，都需要返回本节点。ServiceInfoOriginalServiceT

28、ype原始业务类型，取值：0：短信1：彩信2：WAP3：Widget待扩展ServiceInfoSPCodeSP企业代码ServiceInfoSPNameSP中文简称ServiceInfoServiceCode业务代码ServiceInfoServiceName业务名称ServiceInfoServiceDesc业务介绍ServiceInfoFeeType资费类型，01免费，02按次，03包月ServiceInfoFeeCode资费，正整数，以分为单位ServiceInfoFeeDesc资费描述ServiceInfoUsageGuide业务使用或者订购方法介绍ServiceInfoVerify

29、ImgURL图形验证码URL地址参数值为空时，表示订购不需要验证图形验证码，对本参数值的控制由平台完成。ServiceInfoOrderURL业务订购地址URL，比如Widget业务平台业务订购地址，或者业务在其他通道中订购的地址ServiceInfoCurrentTime当前时间，格式为yyyymmddHHMIssServiceInfoOtherInfo其他信息样例：1.0.02115用户没有定购该业务2900100掌上网1003043手机证券介绍业务031500每月（自然月）收费15元。使用方法介绍http:/widget_host/verifyimg;sid=xxxhttp:/widge

30、t_host/order;sid=xxxx20081223162632Widget业务平台需要处理的DSMP错误码：101：用户手机号码错误（用户没有在MISC注册时返回），SSP把101错误码和Info信息转换成115相同的返回数据包，便于Widget应用统一处理。5.3.2.2.4 重定向返回为了满足业务流程的需要，Widget业务平台需要重定向用户请求到某些其他URL地址，增加重定向返回包，Widget应用收到这种数据包后，自动识别、请求重定向请求目标地址的内容。返回消息为：SSPResp，对应x-widget-msg-type取值为3。Widget业务平台返回值为XML数据包，格式定义

31、如下：序号父元素名称元素名称描述SSPRespSSPRespVersion平台版本，填固定值1.0.0SSPRespMsgType消息类型，填3SSPRespDesc简要描述SSPRespRedirectURL重定向目标地址样例：1.0.03 重定向到新的地址 http:/host:port/download5.3.3 查询订购接口功能：查询Widget应用对应的业务的订购状态，Widget应用根据订购状态提示用户没有订购还是退订业务。通信方式：HTTPXML提供方：Widget业务平台使用方：widget应用HTTP地址：http:/host:port/querysubs?wvid=111U

32、RL参数说明：n wvid：Widget版本代码，唯一标识widget应用版本，根据wvid可以查到对应的业务。Widget业务平台返回值为XML数据包，格式定义如下：序号父元素名称元素名称描述SSPRespSSPRespVersion平台版本，填固定值1.0.0SSPRespReturnValue取值：0：已订购，状态正常1：系统错误10：没有订购该业务11：已订购，订购关系暂停SSPRespReturnInfo信息说明样例：1.0.00已订购，状态正常。5.3.4 业务退订接口功能：退订Widget应用对应的业务。通信方式：HTTPXML提供方：Widget业务平台使用方：widget应用

33、HTTP地址：http:/host:port/unsubs?wvid=111URL参数说明：n wvid：Widget版本代码，唯一标识widget应用版本，根据wvid可以查到对应的业务。Widget业务平台返回值为XML数据包，格式定义如下：序号父元素名称元素名称描述SSPRespSSPRespVersion平台版本，填固定值1.0.0SSPRespReturnValue取值：0：退订请求成功提交1：系统错误10：没有订购该业务SSPRespReturnInfo信息说明样例：1.0.00您退订业务的请求已成功提交。5.3.5 应用版本查询接口Widget应用可以向Widget业务平台发送W

34、idget应用版本查询请求消息，平台根据上报的版本代码，查询系统中是否存在更新的版本，把结果返回给Widget应用，以便提示用户，让用户决定是否需要下载最新版本的Widget应用。通信方式：HTTPXML/文本提供方：Widget业务平台使用方：widget应用接口定义：HTTP地址：http:/host:port/wgverquery?wvid=CMCC.123_1参数说明：wvid ：Widget版本代码Widget业务平台返回值为XML数据包，格式定义如下：序号父元素名称元素名称描述SSPRespSSPRespVersion平台版本，填固定值1.0.0SSPRespReturnValue

35、取值：0：没有更新版本1：有更新版本SSPRespReturnInfo信息说明SSPRespNewVersionInfo新版本信息，ReturnValue取值为1时有效。NewVersionInfoVersionLabel新版本代码NewVersionInfoVersionDesc新版本功能特性说明NewVersionInfoDownloadURL下载地址样例：1.0.01有新版本可以下载 CMCC.123_5 新增功能特性说明 http:/host:port/download5.4 IF-EGN（Widget业务平台Widget引擎）增加运营商网络侧能力访问接口。5.4.1 引擎版本查询接口

36、Widget引擎可以向Widget业务平台发送引擎版本查询请求消息，平台根据引擎上报的版本标识，查询系统中是否存在更新的版本，把结果返回给引擎，以便提示用户，让用户决定是否需要下载最新版本的Widget引擎。通信方式：HTTPXML/文本提供方：Widget业务平台使用方：widget引擎接口定义：HTTP地址：http:/host:port/egnverquery参数说明：HTTP Header中增加参数为：x-widget-engine-version: widget引擎版本Widget业务平台返回值为XML数据包，格式定义如下：序号父元素名称元素名称描述SSPRespSSPRespVer

37、sion平台版本，填固定值1.0.0SSPRespReturnValue取值：0：没有更新版本1：有更新版本SSPRespReturnInfo信息说明SSPRespNewVersionInfo新版本信息，ReturnValue取值为1时有效。NewVersionInfoVersionLabel新版本代码NewVersionInfoVersionDesc新版本功能特性说明NewVersionInfoDownloadURL下载地址样例：1.0.01有新版本可以下载 JIL/1.2 新增功能特性说明 http:/host:port/download5.4.2 安全验证接口为了解决Widget应用在业

38、务订购、计费流程中的安全问题，服务端需要对订购、计费确认请求进行认证，验证通过后，表示请求是Widget引擎发出的，才能正常处理费用相关的逻辑。针对两种引擎，分别使用两种方式实现安全订购、计费： 定制引擎：中国移动定制引擎，与Widget业务平台使用相同的密钥字符串及参数对URL进行加密，服务端验证通过后作为可信请求。 非定制引擎：引擎处理逻辑不可修改，要求订购页面显示图形验证码，用户输入验证码正确后才可以正常订购，以防止Widget应用自动订购等欺诈行为。Widget业务平台为两种安全方案提供统一的处理流程，具体描述如下。5.4.2.1 业务订购通过定制引擎完成的流程图5-1 通过定制引擎业

39、务订购流程图流程说明（接口相关内容在步骤8至12详细说明）：1. 用户使用Widget应用使用内容，当访问到计费内容。2. Widget应用发送HTTP访问请求，该请求需要由Widget引擎来解析。3. Widget引擎发送HTTP请求到Widget业务平台。4. Widget业务平台接收到用户请求，判断用户访问地址为计费地址，需要做订购关系鉴权，作订购、计费控制。5. Widget业务平台向DSMP发送批价鉴权，完成订购关系鉴权。6. DSMP返回用户没有订购此业务需要提示资费信息。7. Widget业务平台返回业务资费信息（详细内容参考IF-WGA接口“业务资费信息返回”中的定义）给Wid

40、get引擎。8. Widget引擎解析平台返回的内容，发现需要提示用户资费信息，在订购URL参数后增加安全验证码参数，定义如下：OrderURL参数初始值为：http:/widget_host/order;sid=xxxx增加安全验证码后为：http:/widget_host/order;sid=xxxx?SecurityID=验证码其中验证码的值为：byte转换成16进制函数（SHA-1算法函数（OrderURL参数初始值+SPCode+ServiceCode+CurrentTime+密钥字符串），算法是否删除待定9. Widget引擎直接展示业务相关信息（包括业务名称、SP、介绍、资费、使

41、用方式等），订购确认链接为步骤8中增加了增加安全验证码后的URL。注意：这个资费提示页面必须Widget引擎直接展示给用户，不能通过Widget应用来展示。10. 用户点击提示页面上的订购确认，Widget引擎接收到请求。11. Widget引擎发送订购请求到Widget业务平台。12. Widget业务平台从URL中获取安全验证码，使用步骤8中相同的算法对安全验证码进行验证，平台需要配置与引擎相同的密钥字符串，验证通过后，还必须通过CurrentTime参数值检查用户会话是否超时（超时时间可以配置，缺省3分钟内有效）。如超时，则返回错误。13. Widget业务平台向DSMP发送业务订购请求

42、，订购Widget应用对应的业务。14. DSMP作订购操作，返回订购成功的结果。15. Wdiget平台向Widget服务代理继续代理用户在步骤1中访问的计费内容。16. 服务端返回计费内容给Widget业务平台。17. Widget业务平台返回内容给Widget引擎。18. Widget返回计费内容给Widget应用。19. Widget应用展示计费内容给用户。20. 用户继续使用Widget。5.4.2.2 业务订购通过非定制引擎完成的流程图5-2 通过非定制引擎业务订购流程图流程说明（接口相关内容在步骤8至17详细说明）：1. 用户使用Widget应用使用内容，当访问到计费内容。2.

43、Widget应用发送HTTP访问请求，该请求需要由Widget引擎来解析。3. Widget引擎发送HTTP请求到Widget业务平台。4. Widget业务平台接收到用户请求，判断用户访问地址为计费地址，需要做订购关系鉴权，作订购、计费控制。5. Widget业务平台向DSMP发送批价鉴权，完成订购关系鉴权。6. DSMP返回用户没有订购此业务需要提示资费信息。7. Widget业务平台返回业务资费信息（详细内容参考IF-WGA接口“业务资费信息返回”中的定义）给Widget引擎。8. Widget引擎返回业务资费包给Widget应用。9. Widget应用解析XML消息后发现是用户未订购，

44、需要处理订购。先通过Widget引擎向Widget业务平台请求验证码图片（URL地址为IF-WGA接口“业务资费信息返回”中的VerifyImgURL字段值）。10. Widget引擎代理请求图片内容。11. Widget业务平台返回图片给Widget引擎。12. Widget引擎再返回图片给Widget应用。13. Widget应用展示业务介绍、资费信息以及验证码图片给用户。14. 用户输入验证码图的值，然后确认订购。15. Widget应用发送业务订购请求（携带用户输入的验证码内容）到Widget业务平台： 提交目标地址为OrderURL参数值指向地址，比如http:/widget_hos

45、t/order;sid=xxxx 提交图片验证码变量名为ImgCode 提交方法为POST16. Widget引擎代理发送订购请求。17. Widget业务平台检查图片验证码参数值是否正确，验证通过后，还必须通过CurrentTime参数值检查用户会话是否超时（超时时间可以配置，缺省3分钟内有效）。如超时，则返回错误。18. Widget业务平台向DSMP发送业务订购请求，订购Widget应用对应的业务。19. DSMP作订购操作，返回订购成功的结果。20. Wdiget平台向Widget服务代理继续代理用户在步骤1中访问的计费内容。21. 服务端返回计费内容给Widget业务平台。22. W

46、idget业务平台返回内容给Widget引擎。23. Widget返回计费内容给Widget应用。24. Widget应用展示计费内容给用户。25. 用户继续使用Widget。5.4.3 运营商网络侧能力访问接口5.4.3.1 查询自己的位置5.4.3.1.1 功能描述终端用户通过Widget引擎向Widget业务平台发出获取自己位置的请求，平台对用户请求进行认证鉴权后将相应结果返回给客户端Widget引擎。5.4.3.1.2 接口设计1) 引擎向Widget业务平台发送获取自己的经纬度信息的请求：类型引擎获取用户自己的经纬度信息请求方法POSTURLhttp:/host:port/csg/1

47、.0/location请求参数体说明：元素类型父元素限制描述NetworkResourceRequest_1_0根元素1, 1根节点operation字符串NetworkResourceRequest_1_01, 1操作类型securityToken字符串NetworkResourceRequest_1_00, 1安全令牌location元素NetworkResourceRequest_1_00, 1位置信息cellId字符串location0, 1小区idmsisdn字符串location0, 1用户号码请求示例： GetSelfLocation xyz +1234123412 2) 平台向

48、引擎发送的响应信息：元素类型父元素限制描述NetworkResourceResponse_1_0根元素1, 1根节点status元素NetworkResourceResponse_1_01, 1返回结果状态code字符串status1, 1状态码desc字符串status0, 1状态码描述location元素NetworkResourceResponse_1_01, 1位置信息cellid字符串location1, 1小区idlatitude字符串location1, 1纬度longitude字符串location1, 1经度accuracy整型location1, 1精确度响应结果示例 0 30567 xxx xxx 200 5.4.3.2 查询他人的位