1、中国联合通信有限公司 中国联通CDMA WAP业务平台 标准接口规范 (Ver 2.1) 中国联合通信有限公司 2004-11-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
2、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 25 变更说明 变更日期 变更者 版本号 变更内容 2004-09-17 孙宇 张
3、峰 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 编写目的 本文将主要解释中国联通C
4、DMA WAP平台计费处理机制,提供针对联通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响应 计费信息确认:用户确认收费策略,如包月、点击及收费金额 计费:根据用户确认的收费
5、策略,作计费处理,计算本次使用服务的费用 2. 一次认证 系统为手机用户提供对所有联通提供的WAP应用的一次认证(Single Authentication)功能。当手机用户使用WAP服务时,对所有CP/SP提供的所有需要认证的服务,只需登录一次,即可以使用这些服务。 一次认证功能具有以下特点: l 为手机用户提供针对所有WAP服务统一认证 l 采用Http Proxy作为实现的基本技术架构 l 基于HttpSession管理的认证系统 l 通过Web Service技术,为CP/SP提供一套完整的认证服务,帮助CP/SP认证用户身份 l 用户信息的集中式管理,集成Ope
6、nwave用户管理系统 l 完善的安全机制 l 兼容Openwave针对CP/SP开放的Http API。 3.CP/SP和业务接入方法 3.1 CP/SP接入方法 CP/SP接入本平台需要向中国联通提交接入申请,CP/SP的应用服务器可以通过互联网或者直接通过局域网、以及VPN和专线方式与中国联通的WAP平台系统相连接。 3.2 业务接入 如果CP/SP的接入申请经过中国联通审核接入了WAP平台系统,就可以提交业务申请, 当CP/SP提供一个业务的时候,在提供该业务的资费策略和优惠信息的同时,由于WAP平台系统是基于URL的内容计费, 因此CP/SP在接入业务之前需要提供该业务
7、如下参数: 参数名称 参数举例 用途描述 业务入口URL http:/ 业务的入口URL,一般为业务首页面,供业务上线时链接使用。 确认URL 表示访问该URL时,如果用户未定制该URL对应的业务,则平台系统会弹出计计费提示信息和订购方式供用户查看和选择。 计费URL 收费服务标识对应收费URL,如果用户访问此URL,平台系统结合用户对此业务的订购策略进行对应计费处理。 示例: 财经新闻服务有目录索引文件 如果确认URL取为: 确认URL和计费URL联通建议不要取到业务的入口,应尽量在二级或者三级页面,使用户能够看到部分内容。 取 另请参照《
8、中国联通互动视界业务计费测试申请表范例》。 特殊说明: (1)对同一业务的计费URL和确认URL可以为包含关系或重复,并可以包含业务入口URL或与业务入口URL相同。 (2)对于同一个业务入口URL只能有一个,但计费URL或确认URL,均可以为多个。 (3)对不同的业务,一个业务的入口、计费或确认URL不允许与另外一个业务的入口、计费或确认URL相同;也不允许出现包含的情况。 (4)由于手机支持的URL长度有限,而且不同的机型支持的长度也不一致,为了能够使各种机型均能够正常使用WAP业务,要求接入的业务内容的URL长度不能够超过128个字符,并不允许出现中文字符。 (5)中国联通C
9、DMA WAP系统只处理80端口,CP申请接入的业务必须使用80端口。不允许出现业务内容对应的URL为其他端口的情况。 (6)中国联通CDMA WAP系统计费网关只针对页面返回的HTTP状态为“200”的页面进行计费过滤处理,对于重定向页面(返回的HTTP状态为“302”),计费网关不做任何处理。因此,CP不能提交有重定向功能的页面作为业务的确认URL和计费URL。 示例: 某业务有两个页面,A页面和B页面。A页面负责将用户请求重新定向到B页面。 如果CP将A页面作为计费URL:当用户访问A页面时,计费网关将请求转发给CP 的web服务器,A页面作重定向操作后,返回给计费网关的状态码
10、是“302”,计费网关对A页面不做计费处理。 如果CP将B页面作为计费URL:当用户访问A页面时,计费网关将请求转发给CP 的web服务器,A页面作重定向操作后,返回给计费网关的状态码是“302”,计费网关对A页面不做计费处理。当网关或者手机接到该http响应信息后,会自动发起对B页面的请求。B页面的响应中如果其状态码为“200”,则计费网关对B页面做计费处理。 (7)对于下载类业务,中国联通建议将确认URL设定为图片预览页面的URL,如preview.jsp,或者图片名称列表页面list.jsp,以便用户能够看到栏目足够信息后,再弹出定制提示页面。 下载类业务的计费URL必须设定为CP
11、业务接收网关下载状态的报告页面,并且必须加上STATUS=OK的下载成功状态参数。 示例:一铃声业务在传递给WAP网关的其接收下载状态的页面URL为:http://wap.uni- (该页面为CP服务器上的页面,应当能够处理状态信息,并给予用户正确中文提示),则用户在进行该业务下的某一铃声下载后,WAP1.2网关会根据手机返回的信息,将用户的访问转到该接收下载状态的页面并在URL上附加下载状态信息,如用户下载成功,用户的请求将会网关被转发到http://wap.uni- ,“STATUS=OK”的内容为WAP1.2网关附加的。STATUS还存在其它内容,如:DOWNLOAD_FAILED,
12、OUT_OF_MEMORY, BROWSER_ERROR等,这些状态都表示用户没有成功完成下载。只有当网关返回的为“OK”的情况下,才能对用户收取费用。因此,CP在上报该业务的计费URL时,应当填写:http://wap.uni- 。 4. 计费方式和优惠方案 中国联通CDMA WAP业务平台负责中国联通WAP业务的计费工作,CP无需自己开发计费系统。中国联通CDMA WAP业务平台提供如下的业务计费方式和优惠方案。CP/SP在提交业务测试申请时,需要填写准确的业务的计费方式以及对应的优惠方案。 4.1 计费方式描述 对业务的基本计费方法分为:免费、按点击计费、按天计费和按包月计费。
13、 免费 指用户免费使用CP提供的该项业务。 中国联通CDMA WAP业务平台提供如下三种基本计费方式,一个业务可以同时选择一种或多种计费方式: 按点击计费: 按点击计费是用户在使用某CP申请并提供的某项业务时,在申请的地址之下的页面中每点击一次该服务计一次费,如:点击一条新闻计0.1元。 按天计费: 按天计费是用户在一天内使用该业务收取一次特定价格的费用,多次进出和重复使用不重复计费。 包月计费: 包月计费是按月一次性收取一定费用,在计费月中用户使用包月服务时,一次性收取包月费用。如用户使用某价格为5元的包月服务,每月初收取用户5元后,用户即可无限制的使用该包月业务,当月
14、不再收取该业务其它信息费。 用户在一个月的前半月定制包月计费方式的业务,当月收取包月费用的全价;在后半月定制包月业务,定制当月只收取包月费用的半价。定制后,若用户不退定该业务,则后续月每月均收取包月费用的全价。 4.2 优惠方案描述 收费业务的某一种计费方法可以分别采用如下几种优惠方案: 试用时长: 在优惠开始和结束日期之内定制该业务,免费使用一段时间。CP/SP可以申请优惠开始和结束日期,以及试用时长。 试用次数: 在优惠开始和结束日期之内定制该业务,免费使用设定的次数。CP/SP可以申请优惠开始和结束日期,以及试用次数。 折扣优惠: 在优惠开始和结束日期之内,按照正式价
15、格的折扣比例优惠。CP/SP可以申请优惠开始和结束日期,以及折扣比例。 固定优惠价格: 在优惠开始和结束日期之内,按照设定的优惠价格(小于正常的收费价格)进行优惠。CP/SP可以申请优惠开始和结束日期,以及优惠价格。 特殊的优惠方案: 服务包计费(优惠套餐)(包月计费): 服务包计费是把某一CP/SP的几项服务捆绑在一起向用户销售的策略,用户定制服务包后,在每月缴纳一定费用(如用户每月缴纳25元),就可以浏览某一内容提供商(CP)提供的服务包内包括的全部服务。 示例: 新闻财经业务选择同时有: (1) 按次计费,每次0.5元,按次计费方式同时选择按照80%折扣优惠,优
16、惠开始和结束时间为:2003/5/1-2003/5/15。(即用户选择该种计费方式,则在2003/5/1-2003/5/15期间,每次使用只收费0.4元) (2) 按栏目计费,每天3元,按栏目计费同时选择按照2元固定价格优惠,优惠开始和结束时间为:2003/5/1-2003/5/15。(即用户选择该种计费方式,则在2003/5/1-2003/5/15期间,每天使用只收费2元) (3) 包月收费,每月10元,包月收费无优惠方案。(即用户如2003/5/11日选择该种计费方式,则在2003年5月,只收费(31-10)/31*10=6.77元,如果2003年6月份,用户未退定,则6月份收费10元






