WAP业务应用程序接口规范.docx

WAP业务应用程序接口规范

（V1.6）

中国移动通信有限公司 版权所有

2003年10月

目 录
第一章 前言 1
1 目的 1
2 适用范围 1
3 参考文档 1
4 术语说明 1
5 文档变动说明 2
第二章 升级快速指南 3
1 业务逻辑变化 3
2 接口变化 4
2.1 页面访问接口 4
2.2 SSO验证接口 4
2.3 Echo接口 4
2.4 Provision（订购关系数据同步接口）接口 4
2.5 正反向订购接口 4
第三章 MISC平台简介 6
1 关于MISC 6
2 Monternet与MISC 6
3 关于梦网服务 6
第四章 WAP业务流程及计费原则 8
1 WAP服务业务接入接口 8
1.1 业务接入流程 8
1.2 业务接入要求 8
1.3 MISC WAP信息源计费原则 8
1.3.1 MISC WAP信息源计费类型 8
1.3.2 按次计费的分类及原则 9
1.4 WAP 服务用户访问流程 10
2 WAP类SP与MISC的物理接口 11
2.1 物理连接示意图 11
2.2 说明 11
第五章 MISC WAP应用程序接口规范 12
1 应用程序接口规范背景介绍 12
1.1 MISC梦网支撑的原则 12
1.1.1 MISC用户Session概念 12
1.1.2 MISC用户Session的创建 13
1.1.3 MISC用户Session的使用 13
1.1.4 MISC用户Session的维护管理 13
2 程序接口通讯方式及协议说明 15
3 应用程序接口规范 16
3.1 业务状态管理接口 16
3.1.1 业务状态管理流程示意图 16
3.1.2 使用实例 17
3.1.3 接口说明 17
3.1.4 Http请求 18
3.1.5 Http响应 19
3.1.6 约定 19
3.1.7 升级注意事项 20
3.2 单点认证接口 20
3.2.1 单点认证的流程示意图 20
3.2.2 页面访问子接口 21
3.2.3 SSO验证子接口 24
3.2.4 Echo子接口 28
3.3 服务质量监测接口 31
3.3.1 使用实例 31
3.3.2 接口说明 31
3.3.3 http请求 31
3.3.4 http响应 31
3.3.5 约定 31
第六章 附件 32
1 MID编码说明 32
2 ServiceID编码说明 32
3 SessionID的编码说明 32
4 WML页面范例 33
5 FAQ 34

第一章 前言
1 目的
本文档作为《MISC平台接口规范》的附件，定义了中国移动移动信息业务中心Mobile Information Service Center（以下简称为MISC）平台V1.5版本与WAP业务SP之间的应用程序接口，目的是为SP开发可接入MISC平台的WAP业务提供指导规范。
本文档并不用于指导SP如何申请接入MISC及业务测试等相关流程，以及WAP的页面规范、WAP应用程序的可用性（如UI），这些问题请参阅CMCC相关文档。
同样，本文档也不用于指导SMS等MISC所支持的其他应用的开发。
2 适用范围
本文档阅读对象：
l 欲接入中国移动梦网WAP服务的SP开发人员
l MISC系统的技术支持人员
3 参考文档
《移动梦网WAP业务管理办法》
《移动梦网WAP业务页面规范》
《RFC 2068 Hypertext Transfer Protocol V1.1》
《RFC 1738 Hypertext Transfer Protocol V1.0》
4 术语说明
1) MISC
Mobile Information Service Center，移动信息服务中心。中国移动集团公司的移动数据业务平台，移动梦网计划（Monternet）的核心平台。
2) MTBS
Message class Third party Business Support System。MISC的子系统，用于支撑消息类的第三方业务。
3) WTBS
WAP class Third party Business Support System, MISC 的子系统，用于支撑WAP类的第三方业务，其功能代理用户与SP之间的服务访问请求，同时产生计费的原始信息。
4) MID
Monternet ID。MISC用户在MISC平台内部的ID号，MID是MISC用户在MISC平台内部的唯一身份标志。SP通过MID来验证MISC用户的身份。
5) SID
Session ID。MISC用户在MISC中的访问Session号。SID标志一个MISC用户在一段时间内对MISC的连续访问中的身份同一性。SID具有非长久性。
6) SP
Service Provider，服务提供商。指可以提供Web/Wap/SMS或其它类型内容和服务的第三方提供商，包括通常所说的ICP和ASP。
7) 梦网服务
梦网服务指由SP遵循中国移动梦网计划为中国移动用户提供的统一在“移动梦网”品牌下的服务。
8) SSO
Single Sign On，单点登录。MISC实现的一种功能服务。MISC用户只需要登录MISC，就可以直接访问整合在MISC中的各种梦网服务，在访问这些梦网服务时，用户不需要重复进行用户登录过程，MISC可以自动传递用户的梦网用户身份给梦网服务，梦网服务根据此梦网用户身份即可判断是否允许使用，从而自动完成梦网服务用户登录过程。
9) Msisdn
用户的手机号码。
5 文档变动说明
假如您已接入移动梦网并阅读过v1.5的相关规范，请参阅第二章的《升级快速指南》，该章节提供了v1.5到v1.6的升级指南，供您快速了解系统的变化。

第二章 升级快速指南
鉴于目前已有很多SP在v1.5.x的版本上开发，为方便这些SP的开发工作，本章节为这些SP提供了快速预览，以便迅速了解系统升级后的变化，如果您是初次接入中国移动的WAP系统，可以略过本章节。
注意，v1.6系统在开发时充分考虑了对原有的接口程序的兼容性，SP按照v1.5开发的业务逻辑完全在v1.6上运行。但v1.6对部分接口和业务流程进行了优化，对V1.5的接口支持仅持续到2003年12月31日，因此，SP应尽快对v1.5开发的业务逻辑应进行相应的调整，以充分利用v1.6的特性，并改善用户体验。
1 业务逻辑变化
l 优化了页面内容过滤
V1.5中WTBS在进行页面过滤替换时，对URL的处理是添加了一系列的参数，有时导致页面内容过大，造成了服务访问的异常，在V1.6中，WTBS对URL替换进行了简化处理，对梦网服务的服务页面大小造成的影响降低到了最低程度。
l 优化了用户Session的维护
V1.5需要SP向MISC系统不多发送Echo，以延续用户在MISC上的会话，在v1.6中，系统会自动维护用户的会话存活期，仅对特殊的业务（绕开WTBS的梦网服务），SP仍需使用Echo接口维持用户在MISC上的会话。
l 优化了用户身份信息的传递
V1.5中，用户身份信息的传递是通过页面服务访问接口传递用户的SessionID，SP的梦网服务通过SSO验证接口来完成用户身份信息的置换来完成的，在v1.6中，用户身份信息将通过页面服务访问接口直接传递，SSO验证接口变为可选，仅出于兼容性仍维持了该接口的存在。
l 屏蔽用户手机号码的传递
在1.5中，经由WTBS代理访问，对封装于HTTP头中的用户手机号码没有严格过滤，在v1.6中，经由WTBS代理访问的用户手机号码将严格过滤，仅对特殊业务（业务申请时要求传递用户手机号码的梦网服务）在页面服务访问接口中传递用户的手机号码。
l 支持相对路径
在V1.6中，支持相对路径，SP可以在WML页面内容中使用相对路径,WTBS在进行过滤时会自动将相对路径替换为绝对路径，只是SP要考虑到相对路径替换为绝对路径时对页面内容大小的变化不要影响到用户的访问。
2 接口变化
2.1 页面访问接口
在v1.6的页面访问接口中增加了MISC_MID和MISC_Msisdn两个参数，这两个参数不会同时传递，而是根据SP业务特性来决定，一般而言，MID会直接传送给SP，对于特殊业务，如用户通过手机浏览铃声（单音）图片（单色）而通过短信下发的业务，SP在通过短信下发时需要手机号码，对于此类业务则传送Msisdn。
注意：
l V1.6的SessionID编码方式与V1.5的编码方式不同，SessionID请参阅附录中的SessionID编码规则。
l 为确保服务访问的安全性，防止仿冒其他用户访问的情况，SP的梦网服务应确保仅来自于MISC系统的页面访问是可信的，具体实现方式可以在WEB Server上限制服务路径的访问IP，或在应用程序进行控制。
2.2 SSO验证接口
由于在v1.6中用户身份信息已在页面访问接口中传递给了SP，因此，本接口已无实际的使用意义，只是出于兼容性考虑，为SP基于v1.5运行的系统提供平滑过渡。
2.3 Echo接口
在v1.6中，对于经过WTBS全程代理的业务，已无需SP进行Echo来延长用户在MISC WAP系统上的会话存活期，WTBS会自动更新用户的会话存活期。
特殊类型的业务需要绕开WTBS的，由于用户与WAP应用之间的交互不再经过MISC系统，SP仍需调用该接口来延长用户在的会话存活期。
注意：
l V1.6的SessionID编码方式与V1.5的编码方式不同，不再携带MISC的编码信息，SessionID请参阅附录中的SessionID编码规则。
2.4 Provision（订购关系数据同步接口）接口
最新的订购数据同步接口将由中国移动颁布，名称为《数据业务管理平台接口规范—SP分册》，该接口采用了Web Service的通讯方式。
但MISC系统仍提供v1.5的接口，以保持兼容性，请SP在新的接口颁布后即刻向新的接口转换，V1.5接口的支持将仅维持到2003年12月31日。
2.5 正反向订购接口
正反向订购接口是指为用户先体验后服务的，本着“先尝后买”的原则，用户先在SP访问服务的免费试用内容，当SP认为用户已充分体验了该业务时，SP可利用此接口让用户到MISC系统完成服务的订购。
该接口向前兼容，即SP采用 v1.5的订购接口参数形式，如UserType=B&ServiceID=xxx，仍然可以在V1.6平台上完成订购，但由于系统平台的演变，主要是ServiceID的非唯一性，SP应该在2003年12月31日前完成向v1.6的接口过渡
v1.6的接口格式为 ?SessionID=xxx&SPID=xxx&ServiceID=xxx&SPURL=xxx
l SessionID：用户的Session唯一标识（是用户通过Portal访问SP的服务时Portal传递给SP的MISC_SessionID）
l SPID：用户所访问服务的SP编码。
l ServiceID：用户所访问服务的服务编码
l SPURL：订购成功后的下一跳页面URL（这是一个可选参数，如果不带，则XTBS在用户订购成功后，会以该服务的访问URL作为下一跳的目标URL）。
v1.6的正反向订购接口增加了ICPID，是为了保证服务的唯一性。
v1.6的正反向订购接口目前增加了SPURL参数，该参数用于指定，当用户在Portal上完成业务订购后返回到SP在URL里指定的应用服务的位置；该参数为可选，如SP没有提供BackURL的参数，用户完成业务订购后，系统将重定向用户到服务链接地址，即SP的正常服务访问的入口地址。

第三章 MISC平台简介
1 关于MISC
MISC(Mobile Information Service Center) 是为运营商提供的可快速启动各种数据业务的平台，是一个强大的资源调度平台。它连接运营商的基础网络及业务支撑系统（客服系统、营业系统、计费系统），为SPs提供各种电信资源（如短消息中心资源、用户信息资源、语音资源、传真资源等）、功能资源（如单点认证、计费、漫游控制、个性化等）及各种公共的资源引擎（如TTS、地理位置、语音交互、推送信息等）。MISC平台在移动运营商和内容提供商之间，起到一个“桥梁”或“纽带”的作用，使得运营商以最快速、最简单的模式开通新业务；各内容提供商不用关心网络层的详细技术，能够专注于内容、应用的开发，以更低廉的成本、在最短的时间内提供新业务；各类移动用户可以通过任意终端（WAP手机、PDA、PC、普通电话、传真机等），采用SMS、WAP、WEB、话音/传真方式，在任何地方就近接入“移动梦网”门户，使用新业务。
2 Monternet与MISC
MISC系统是中国移动“移动梦网”计划中的技术支撑平台、业务资源调度平台，系统采用先进的技术和高扩展性的系统架构，建立一个有中国特色的全网统一的移动数据服务平台，提供全方位信息服务和商务服务的管理，是SP与用户之间的纽带。MISC系统为移动业务提供商在提供信息服务时，在电信资源、客户信息、ICP管理、信息计费、客户漫游、一次认证与授权等等方面提供了强有力的支撑。表现为：
l 统一的用户管理系统，抓住客户信息，向ICP提供客户信息（个性化服务）与一次认证与授权；
l 标准的本地化服务，全局漫游服务，降低客户的信息使用成本，提高使用效率；
l 信息的统计与计费、漫游清算服务，方便运营商ICP内容提供商收取服务费用；
l ICP接入的统一管理，有利于创造统一的服务品牌。
3 关于梦网服务
梦网服务是指集成在Monternet中提供给移动梦网用户使用的各种服务。梦网服务通常是非中国移动开发和运营的第三方应用系统，可能基于WEB、WAP、SMS以及所有MISC支持的其他任何业务承载类型（如VOICE、FAX），目前最主要和常见的业务类型是SMS服务和WAP/WEB服务，本文档特指的WAP。
一个梦网服务是MISC系统可见的最小业务单元。每个梦网服务都拥有服务名称、服务ID、服务地址、计费类型、计费价格等业务属性。一个梦网服务内部可以拥有多个子业务，但这些子业务与MISC不会有单独的业务和技术接口，也不可单独计费。
按照业务面向的用户范围，梦网服务分为全网业务和本地业务。全网业务面向中国移动全网所有用户，本地业务则只面向业务接入地的中国移动用户。
MISC平台为梦网服务提供了代计费、服务整合和单点登录等核心功能。梦网服务必须遵循MISC规定的业务和技术接口，才可以正常使用这些功能。

第四章 WAP业务流程及计费原则
1 WAP服务业务接入接口
1.1 业务接入流程
每个梦网WAP服务必须通过规定的业务流程，在相应的移动梦网业务管理部门注册登记，按照移动梦网对WAP服务的要求实现各种接口，才可以通过MISC系统进入移动梦网门户集中提供给梦网用户使用。
全网性WAP服务是指面向中国移动全网用户提供的服务，需向全国梦网运营中心提出申请。
地方性WAP服务是指面向中国移动某省公司所属用户提供的服务，业务接入需向中国移动各省公司提出申请。
具体的业务流程和业务管理规范，请参见《中国移动移动梦网业务管理办法（WAP业务分册）》及中国移动各省公司的相关业务规范。
1.2 业务接入要求
每个梦网WAP服务必须符合移动梦网WAP服务的各种要求。
1). 服务参数要求
梦网WAP服务在服务注册时必须向移动梦网提供有关的服务参数，以便MISC进行服务管理。这些参数包括服务名称、服务地址、计费类型、计费价格等等。具体的参数列表和说明请参见中国移动有关文档。
2). 服务质量要求
梦网WAP服务必须满足移动梦网要求的服务质量指标。这些服务质量指标包括页面质量、服务的可用性、服务稳定性等方面。具体要求请参见中国移动有关文档。
3). 服务程序要求
梦网WAP服务必须遵循MISC规定的程序接口，才能正常使用MISC平台为梦网服务提供的代计费、服务整合和单点登录等核心功能。
1.3 MISC WAP信息源计费原则
1.3.1 MISC WAP信息源计费类型
MISC对WAP业务目前支持包月和按次计费两种方式。
为了正确实现代计费功能，梦网WAP服务的页面URL地址必须遵守一定的规则，请参阅 “第五章的4 WML页面范例”。
1.3.2 按次计费的分类及原则
对于按次计费的业务，MISC系统支持两种类型的业务，一种是常用的按条访问方式，另一种是事务型的业务，对于这两种类型的业务，其规范有所不同。
1.3.2.1 单条信息类业务
单条信息类的业务主要是指用户通过一次请求交互就可以获得服务，他们的共同特征是一次访问就可以完成一个业务过程，在这种情况下，SP与MISC之间是一个页面格式的约定，其接口相对比较简单，在页面中，有关内容应该执行MISC的相关规范。
示例说明：
例如 某SP提供新闻服务业务，其服务按次计费，则SP必须提供其服务访问的URL以作为计费依据，如
其
如后续页的连接指向
如果实现有困难，建议对此类WAP服务采用包月计费方式。
1.3.2.2 事务处理性WAP业务
对于需要多次交互才能完成的业务，我们称之为事务性业务，在事务性业务中，有几个概念需要说明：
（1）事务节点：一个事务型的业务，一般是需要多步操作才能完成一次业务，对于每次操作经过的节点，称之为事务节点。
（2）必经节点：在事务节点中，有某些节点是必经的，也就是一次业务的提交后，其所经历的节点列表中，必须要有这个节点存在，这次业务才算合法。
（3）计费节点：在事务节点中，经过了这一个节点，就可以认为该业务已经完成，可以进行计费处理了，在一个事务中，只能有一个事务节点是计费节点。
事务节点由SP在申请梦网业务时提交，并确定必经节点和计费节点，在页面的交互中，各节点的流转由SP自己进行控制，遵照MISC的页面规范进行页面设计，以保证页面交互能够进行下去。
示例说明：
例如：某SP提供航班查询服务，该服务包含了三个CGI程序、step1.cgi 返回用户一个录入界面，让用户选择出发城市、降落城市、输入出发时间等信息，step2.cgi返回用户一个录入界面，让用户输入姓名、地址、联系方式等信息，Step3.cgi返回用户查询结果。
Step1.cgi、step2.cgi、step3.cgi是SP提供该项业务的全部的URL，称之为事务节点
由于SP为用户提供了个性化服务，如某用户已在SP的网站上注册了姓名、地址、联系方式等信息，该用户在访问航班查询服务时，SP根据用户的MID已获取了用户的个人信息，所以对该用户不需要经过step2.cgi,也可以完成航班查询服务，因此，对SP提供的WAP服务而言，step1.cgi step3.cgi是必经节点。
计费节点是step3.cgi，因为用户只有访问到step3.cgi才会对用户计费、而step1.cgi是必经节点，step2.cgi是事务节点。
因此，SP在提供事务性的按次计费的WAP业务时，SP必须明确其唯一的计费节点(URL)，作为计费的依据。且该计费节点必须合理，如对于以上示例，SP不能指定step1.cgi 或step2.cgi作为计费节点。
在本版（V1.5）MISC系统中，SP必须为其事务性WAP服务指定一个唯一的计费节点作为计费依据，在系统完善后，SP需指定计费节点、必经节点，MISC系统对用户的访问将以这些作为计费依据。
1.4 WAP 服务用户访问流程
l 用户访问MISC的WapPortal
用户使用支持WAP功能的手机连接到WAPGateway，访问到移动梦网的WapPortal，
WapPortal对用户进行鉴权，判断该用户是否是梦网用户，如果不是，则需要用户通过WAP注册页面或WEB注册页面（）注册，如果用户已注册则生成用户的个性化首页面。
l 用户访问服务
用户在终端上点击服务，服务的请求发送给MISC的WTBS，WTBS代理用户向SP发出请求，SP对请求做出响应，包括向MISC WAP Portal发起SSO验证请求等操作，如果是合法访问，则给用户返回页面，页面中必须含有“返回梦网”的链接，用户可以继续使用SP的服务，也可以随时通过“返回梦网”的链接返回到梦网的WAP页面。
从用户体验的角度服务访问的流程是透明的，用户并不清楚中间的过程，用户看到的是点击了服务后，返回了服务页面。
l MISC.WTBS根据服务结果生成计费日志
WTBS在确认用户进行了服务访问后， WTBS生成计费日志。因此，只有通过MISC的WTBS对SP进行访问时，WTBS才能对SP业务进行代计费，而对于任何其它方式的直接访问SP页面的行为，我们将不做计费，这也是WAP业务计费的基本原则。
2 WAP类SP与MISC的物理接口
2.1 物理连接示意图

2.2 说明
MISC与SP之间的物理连接通过Internet或专线联接。
WTBS负责代理用户与SP之间的服务请求，以及业务状态管理的数据同步，同时，在特殊情况下，为完成MISC的单点登录等要求，SP还需要向MISC的WAP Portal发起SSO验证请求及Echo请求。
对SP的主动访问都是来自于WTBS，考虑到安全因素，SP应对IP地址进行鉴权，确认只有来自于WTBS的IP才可以访问SP提供的计费服务和服务状态管理即Provision接口，防止仿冒来自于WTBS的访问。
对于Echo和SSO接口，都是由SP主动向MISC的WAP Portal发起，安全管理由MISC负责。

第五章 MISC WAP应用程序接口规范
1 应用程序接口规范背景介绍
1.1 MISC梦网支撑的原则
l 用户与SP提供的收费WAP服务之间必须存在服务订购关系
由于MISC整合了由SP提供的各种WAP类服务，并且MISC为SP提供代计费功能，因此，MISC必须确认用户在使用SP的服务的时候是充分知晓SP WAP服务的价格，也就是说，MISC必须确认用户与SP WAP服务之间存在订购关系，MISC才会让用户访问该WAP 服务。
而订购关系的发生，是用户在访问MISC的WAP Portal/WEB Portal时，用户可以选择Portal上提供的服务并进行订购、或对已订购的服务进行取消、暂停、激活等操作，MISC会将用户的业务状态的变化信息通知给SP，这种数据的交互需要通过双方约定的协议格式进行，这就是业务状态管理接口。
l 单点认证原则
WAP 门户上的WAP服务是由各SP提供的，每个SP需要对用户进行鉴权，以便了解该用户是谁。如果用户访问WAP Portal上的每个服务用户都需要重复地输入用户名密码等信息，这样带给用户的体验很差，会严重影响到用户对WAP业务的认可和使用。为此，MISC提出了单点认证的概念，即用户在进入MISC时，MISC会对用户进行鉴权，当用户访问MISC上提供的任何一个WAP服务时，MISC通过传递用户的鉴权信息给SP，SP通过与MISC的接口对鉴权信息的验证，可以判断用户是谁，这样就无需要求用户进行再次的登录。
MISC系统通过导入Session这一会话概念及单点认证接口保证了单点认证的实现，下面作进一步介绍。
1.1.1 MISC用户Session概念
MISC一个重要的基本核心功能是用户管理。
一个中国移动用户通过在移动梦网门户中注册成为梦网用户后，其在MISC中就拥有了一个长久的唯一身份标志——MID（Monternet ID）。MID是梦网用户在移动梦网中的统一的身份标志，由MISC分配产生并保存维护。在需要的时候，梦网服务可以通过获得一个梦网用户的MID来确定该用户的梦网用户身份，梦网服务对用户的服务使用权限判断和计费均以此为依据。
由于MID对梦网用户的重要性，出于安全的考虑，在梦网用户、MISC和梦网服务间通常的业务交互过程中，并不轻易通过直接传递MID以区别用户身份，而是在用户每次访问MISC时，由MISC为梦网用户建立一个临时的身份标志——SID（Session ID）。
Session用于在一定时间内用户对服务的连续访问中保持用户身份的连续性。SID具有一定的存活期，不具有长久性。MISC内部有一套完整的机制负责用户Session的创建、维护管理和销毁。
与MISC的用户Session相对应，梦网服务通常也应该有自己的用户Session机制，以便在梦网用户对自己的连续访问中可以保持身份连续性。梦网服务可以直接使用MISC用户SID，也可以自行创建新的用户Session，但此新的用户Session应该与MISC用户SID建立对应关系。
1.1.2 MISC用户Session的创建
当梦网用户登录移动梦网门户时，MISC就会创建一个Session，该Session ID即为该用户的SID，这就是本次访问中该用户的身份标志。
用户Session只有一定的存活期，如果存活期结束之前该Session没有任何活动，MISC即销毁该Session，此梦网用户相应地就会丧失身份，此时该用户必须重新登录移动梦网。在创建Session的同时，MISC启动对该Session存活的倒计时。用户对MISC的每一次有效访问，都会按照规则修改该用户Session的存活期。
1.1.3 MISC用户Session的使用
梦网用户的SID不仅在移动梦网门户中有效，它的使用范围也延伸到集成在移动梦网门户中的各种梦网服务。
在移动梦网门户中，通过选中服务列表中的某一梦网服务，梦网用户就可以通过MISC直接访问到该梦网服务的主页，从而使用SP通过MISC提供的梦网服务。此时MISC会在发向梦网服务的首次主页访问请求中附加SID参数以向梦网服务表明该用户的身份。梦网服务在首次获得该SID时，应该无法识别该用户的真实身份，此时，梦网服务应该向MISC发出SSO请求，要求获得该SID的真实用户身份。MISC将会通过SSO响应告诉梦网服务该SID对应的梦网用户真实身份（MID）。梦网服务据此即可判断该用户是否可以合法使用服务。
在梦网用户进入梦网服务后，梦网服务端同样应该为该用户建立Session维护机制，以便该用户在下一个页面访问中保持身份连续性。梦网服务可以直接使用MISC初始传递过来的用户SID，也可以自行创建新的服务内部用户Session，但此新的用户Session应该与MISC用户SID建立对应关系，并缓存维护该用户SID。无论是否直接使用MISC SID，梦网服务都需要为此Session设立服务内部的存活期。建议此存活期设置不要长于MISC的用户Session存活期。
1.1.4 MISC用户Session的维护管理
在梦网用户对MISC完成一次访问后，用户Session的剩余存活期不断减少。直到该用户对MISC发生了一次新的有效访问，其Session又重新获得更新后的存活期。
在梦网用户通过MISC进入梦网服务后，一般情况下，用户对梦网服务的访问需要经过MISC,MISC会自动维护用户的会话，特殊业务用户对梦网服务的后续访问通常不再经过MISC，此时用户虽然仍然在继续使用梦网服务，但是MISC无法直接感知用户的活动，因此在MISC中，该用户Session的剩余存活期会不断减少，直至被销毁，失去在MISC中的梦网用户身份。此时如果该梦网服务需要与MISC交互，将会得到该用户为非法用户的提示。
为了避免这种情况的出现，当梦网用户在梦网服务中的Session依然存活时，梦网服务应该在适当的时候向MISC发出Echo请求，以便通知MISC某用户Session依然存活，MISC在收到Echo请求后会将该用户Session的剩余存活期更新。关于Echo接口，请见后面的详细说明。
梦网服务的Echo时机，由SP自行决定，MISC程序接口中并不做限制。最简单的策略是在每次收到/响应用户页面访问请求时，同时向MISC发送Echo请求。这个策略的问题是可能产生过多的Echo请求，影响梦网服务和MISC的性能。比较高级的解决方法是同时结合定时机制，只在一定时间以后才发送新的Echo请求，缺点是实现会比较复杂一些。
l 服务质量原则
梦网服务是在中国移动集团公司的“移动梦网”品牌下向用户提供的收费服务，因此，为保证“移动梦网”这一中国移动数据业务品牌的质量，要求SP提供的梦网服务具有良好的可靠性（7X24）、可用性。可用性在中国移动的WAP页面规范中定义，包括UI、获取服务的点击次数等。服务的可靠性将通过服务质量监测接口来完成。即SP每申请接入一项服务，都需要提供一个URL来说明该项服务的状态，MISC将定期向该URL发出请求，并记录SP提供的状态报告，用于标识SP提供的该项服务的质量。
基于梦网服务的以上三个原则，SP在接入MISC提供WAP服务时，SP的WAP应用程序与MISC之间必须遵守以下三个接口：
（1）业务状态管理接口
SP端必须指定一个应用程序，如（http://www.SP.com/provision.dll）来正确接受并相应来自于MISC的业务状态管理数据。
（2）单点认证(Single Sign On)接口
单点认证接口是指为完成用户在通过MISC的WAP Portal访问用户的应用服务时实现SSO功能，所需要完成的一系列操作，主要包括以下三个子接口：
首先，当用户通过MISC的WAP Portal访问SP的服务时，MISC会在URL后附加MISC_SessionID、MISC_ServiceID、MISC_AccessMode、MISC_MID或MISC_Msisdn四个参数，同时，SP需要在其WAP页面上附加返回梦网的链接，以便用户返回梦网，这些称之为页面访问接口
当SP接到来自MISC的用户请求时，为确认用户的身份，SP需要向MISC发送SSO请求，以便确认用户的SessionID有效合法，同时获得用户的MID，称之为SSO验证接口
在用户在SP访问期间，为维持用户在Portal上的Session的有效性，以便用户从SP返回WAP Portal时使用户无需再次登录，SP需要在用户访问时向MISC发出Echo请求，称之为Echo接口。
（3）服务质量监测接口
SP端必须提供一个服务质量监控程序的URL，如
以上所有接口的协议约定请参见本章的 “3 应用程序接口规范”。
2 程序接口通讯方式及协议说明
本章以后部分均假设某示例SP（SP1）的地址为：

其归属MISC的WAP Portal站点地址为(在通过业务接入流程后由运营商指定)：

其相应的专用MISC WTBS地址为(在通过业务接入流程后由运营商指定)：

1) SP与MISC之间的通信协议采用HTTP/XML协议。
2) SP与MISC之间的所有命令交互均使用POST方式的HTTP请求。
命令请求和响应的内容都放在Http请求Entity Body中，并采用XML格式，内容类型（Content-Type）为：” text/plain”，在HTTP的包头里面的表示为：“Content-Type: text/plain”，请注意，在包头里，相关的限制和约定以HTTP及XML协议为准。
MISC命令交互中Http请求和响应体中的XML格式如下：
<?xml version=“1.0” ?>
<misc_command version=”1.5”>
<command_name>command_name</command_name>
<command_data_block>
<data_tag1>data1</data_tag1>
<data_tag2>data2</data_tag2>
……
</command_data_block>
</misc_command>
说明：

XML 元素
类 型
意 义
说 明
misc_command

MISC命令请求标志，MISC命令请求XML包的根标记（Root Tag）。所有MISC命令内容必须位于此标注中
version为本接口规范版本号
command_name
字符串
MISC命令名称。其值可能为：
provision;
provision_response;
sso;
sso_response;
等等
在同一个包中只有一个命令。
command_data_block
data_tag子元素数组
MISC命令数据块，所有MISC命令数据项必须置于此块内。

data_tag
随命令定义
MISC命令数据项
此标注数量、名称和元素类型均据命令不同来定义
3) Http响应中命令结果值约定
通常的MISC命令交互中，在Http响应体中，一个XML数据包反映了命令处理结果。在该XML数据包中，通常包含一个result_id（或者是其他Tag名）元素，该元素表示此次MISC命令交互是否完成。
result_id用一个整数值来表示命令处理结果。通常，“0”表示命令成功；其他任何数值均表示命令失败；在需要的情况下，可以用特定的数值（一般用负数）表示与该命令有关的一个特定的错误类型。如下是一个命令结果表示规则示例：
result_id = 0： 命令处理成功；
result_id = -1： 命令处理失败。失败原因：无效的spid；
result_id = -2： 命令处理失败。失败原因：无效的sppassword；
result_id = -3： 命令处理失败。失败原因：无效的sid；
result_id = -4（或其他任何值）： 命令处理失败。失败原因：其他未知原因错误。
3 应用程序接口规范
3.1 业务状态管理接口
3.1.1 业务状态管理流程示意图

3.1.2 使用实例
服务状态管理接口用于在MISC中用户对某个梦网服务的使用状态发生改变时，MISC与梦网服务间同步服务状态。用户对梦网服务的使用状态改变包括开通服务、停止服务、暂停服务和激活服务等动作。当用户在梦网门户中通过上述动作改变了对某一个梦网服务的使用状态时，MISC内部将记录此服务状态的改变，同时将此信息作为一个Http请求发送给该梦网服务相应的处理模