中国联通CDMA WAP业务平台标准接口规范.docVIP

中国联通WAP业务平台标准接口规范 中国联合通信有限公司 2004-1目 录 变更说明 4 1．概 述 5 1.1 编写目的 5 1.2用语解释 5 2. 一次认证 5 3．CP/SP和业务接入方法 6 3.1 CP/SP接入方法 6 3.2 业务接入 6 4. 计费处理的方法 7 4.1 计费方式描述 7 4.2 优惠方案描述 8 5. Download fun（下载类服务） 9 6. WAP PUSH 10 6. 1 通过华友增值业务平台进行PUSH 10 6.1.1接口描述 10 6.1.2发起方系统 10 6.1.3接收方系统 10 6.1.4 接口协议 10 6.1.5访问控制机制 11 6.1.6调用函数 11 6.1.7接口形式 11 6.1.8 示例代码 13 6.1.9 注意事项 15 6. 2通过综合业务接入管理平台进行PUSH 15 7. 关于获取手机用户的唯一标识 15 8. 关于手机型号的参数获取方法 16 9. 用户归属地机构获取方法 16 变更说明 变更日期 变更者 版本号 变更内容 2004-09-17 孙宇 张峰 V2.02 新增 章节9：用户归属地机构获取方法； 删除 章节6. 1：通过PPG网关进行PUSH； 删除 原章节9：CDMA返回上级规范，原规范内容请参见《中国联通CDMA WAP业务返回规范》； 更改本规范名称为《中国联通CDMA WAP业务平台标准接口规范》； 调整了部分语言描述。 2004-11-2 孙宇 V2.1 补充章节3.2：下载类业务计费URL要求；补充平台计费针对重定向页面的处理方式； 修改章节4.1：将按栏目计费统一更名为按天计费； 调整了部分语言描述； 本次修改部分用红色标明。 1．概 述 1.1 编写目的 本文将主要提供针对联通CDMA WAP业务的计费、认证等标准接口规范。 1.2用语解释 GW：Openwave WAP Gateway，Openwave WAP 网关 CP/SP：内容提供商/服务提供商 DF：Download Fun PF：Portal Framework IM：Instant Messaging OPM：Openwave Provision Manager Http Request：Http请求 Http Response：Http响应 计费信息确认：用户确认收费策略，如包月、点击及收费金额 计费：根据用户确认的收费策略，作计费处理，计算本次使用服务的费用 2. 一次认证 系统为手机用户提供对所有联通提供的WAP应用的一次认证（Single Authentication）功能。当手机用户使用WAP服务时，对所有CP/SP提供的所有需要认证的服务，只需登录一次，即可以使用这些服务。 一次认证功能具有以下特点： 为手机用户提供针对所有WAP服务统一认证 采用Http Proxy作为实现的基本技术架构 基于HttpSession管理的认证系统 通过Web Service技术，为CP/SP提供一套完整的认证服务，帮助CP/SP认证用户身份 用户信息的集中式管理，集成Openwave用户管理系统 完善的安全机制 兼容Openwave针对CP/SP开放的Http API。 3．CP/SP和业务接入方法 3.1 CP/SP接入方法 CP/SP接入本平台需要提交接入申请，3.2 业务接入 如果CP/SP的接入申请经过中国联通审核接入了WAP平台，就可以提交业务申请， 当CP/SP提供一个业务的时候，在提供该业务的资费策略和优惠信息的同时，提供如下参数参数名称 参数举例 用途描述 业务入口URL http://wap/index.jsp 业务的入口URL 确认URL /wap/index.jsp 表示访问URL时，系统会弹出计信息供用户查看和选择。 计费URL /wap/content/ 收费服务标识对应收费URL，如果用户访问此URL， 示例： 财经新闻服务有目录索引文件/news/finance/index.jsp，列出所有财经新闻供手机点击之后再链接到某项具体内容，但是当手机访问到该目录的时候是不应当计费的。具体的新闻则放在：/news/finance/content/目录里面，当点击新闻目录中的某一项的时候，自动链接到content目录里的具体新闻内容页面。 如果确认URL取为：/news/finance/index.jsp，当用户访问到该URL的时候，如果该用户未定制该业务，WAP平台系统会弹出计费信息供用户查看和选择。/news/finance/content/作为计费URL，则用户成功访问新闻内容页面后才真正计费。 另请参照《中国联通互动视界业务计费测试申请表范例》。 特殊说明： （1）对同一业务的计费UR