《动易2005整合接口开发规范.docVIP

动易2005整合接口开发规范 概述 动易2005 整合程序采用网页表单提交+网页跳转两种方式实现动易和目标程序的同步注册、登陆、注销，取代了以往的通过互相读写cookies的整合方式。整合的系统以及动易的系统均无需更改数据库，不影响以后升级。 目标程序可以采用任意语言编写接口，只要符合开发规范的接口，都可以登记组合到整合的系统中。与动易系统、动网论坛等组成一个全站统一登陆注销的完整系统。 2005版整合程序中的每一个程序可以放置于不同服务器、不同域名之下，通过一个统一的网站私钥识别程序的身份。 目标程序提交数据到动易 为了支持同时整合多套系统，必须由整合的多套系统中的一套作为中心系统，负责接受来自多系统中任何一个系统的数据，并将数据发送到所有其它系统。在2005版整合接口中，我们规定以动易2005作为整合的中心系统。所有其它整合进来的程序的任何涉及用户名、用户密码、用户Email、提示问题、答案（以下称“基本数据”）的操作，都应该先发送到动易系统的相关文件进行处理。动易系统会自动通知其它程序进行数据更新。 各项操作传递的参数说明 注册 用户在整合系统中的任何一个页面点击“注册”以后，该系统应该将其引导到动易的注册页面进行后续操作。此过程可以通过修改目标程序的链接实现，或者修改目标程序的注册文件进行跳转。 动易的注册页面： 动易目录/Reg/User_Reg.asp?ComeUrl=来源页面 参数说明：注册只需传递一个参数，即用户进入注册前所在页面的完整URL，动易在处理完注册以后，会返回该地址。 登陆 用户在任何页面遇到登陆表单，输入用户名、密码、cookies保存选项后，表单数据应当提交到动易的登陆验证程序进行验证，通过验证以后，动易系统会通知所有整合的系统允许该用户登录，然后返回用户登录前所在页面。 动易的登陆验证程序：动易目录/User/User_ChkLogin.asp?username=用户名UserPassword=用户密码CookieDate=Cookies保存选项ComeUrl=来源地址 参数说明：这里传递的用户名、密码都无需加密。四个参数可以采用Get或者Post方式传递均可。ComeUrl必须是完整URL。 注销 用户在任意页面点击“退出”或者“注销”，系统应当引导用户到动易的用户注销页面。动易会注销该用户的登陆并通知整合系统中的其它程序做同样操作。 动易的注销程序：动易目录/User/User_Logout.asp?ComeUrl=来源地址 参数说明：同注册。 资料更新 用户在整合系统中任意一个程序进行基本资料的更新，都应到动易的用户控制面板进行，以确保全站信息的同步。 动易的资料修改程序：动易目录/User/User_Info.asp?Action=ModifyPwd 参数说明：无参数 删除用户由于删除用户必须以动易管理员身份登陆动易后台，因此未提供对整合系统中其它程序同步删除用户的操作。建议需要删除用户时，登陆动易后台进行操作。动易系统会通知其它程序做相应处理。 动易向目标程序返回数据 动易向所有目标程序返回数据时，采用规范的格式，传递的是相同或类似的参数，目标系统的接口接到动易返回的数据后，先进行安全验证，通过后即进行相关操作，操作完成不提示信息自动退出。 参数详解：目标接口程序?action=操作类型name=用户名Md5Info=验证串pass=密码lock=是否锁定question=提示问题answer=答案email=电子邮件sex=性别save=Cookies保存选项 目标接口程序，指的是与动易进行整合的系统（例如Dvbbs）的针对和动易整合的接口文件。在官方提供的动网整合包中，此接口文件为Interface.asp。用户可以根据需要自行开发整合接口文件，文件名建议使用Interface.asp/Interface.php/Interface.aspx/Interface.cgi，也可以使用其它文件名，只需在动易目录/Inc/UpiConfig.asp中做相关设置即可。 Action参数传递的是所要进行的操作。目前共有以下几种：action=AddUser：用户注册，需传递全部参数；action=LoginUser：用户登录，需传递用户名、密码、验证串、Cookies保存选项action=LogoutUser：用户退出（注销），传递用户名、验证串action=ModifyInfo：用户资料更新，传递完整参数action=DelUser：删除用户，传递用户名、验证串 Md5Info是整合的各个系统之间相互验证身份的凭据，因为不同的网站设置的SecurityKey不一样，因此Md5Info相同的就说明是来自整合的某一个程序。Md5Info的生成方式：先将要操作的用户名