互动状态的接口参考-RTX腾讯通.DOC

互动状态的实现指南 腾讯科技（深圳）有限公司 2004年11月3日 目录 一、用户的状态获取 - 3 - 1、获取单个用户的状态： - 3 - 2、获取多个用户的状态 - 4 - 二、点击用户的状态给用户发送消息 - 5 - 三、互动状态的接口参考 - 9 - 1、复杂接口（含有点击操作的） - 9 - 2、简单接口（无点击操作） - 10 - 1）返回在线状态图片 - 10 - 2）返回在线状态文字 - 10 - 四、ASP应用实例 - 11 - 1、ASP的应用环境 - 11 - 2、ASP实例详解 - 11 - 1）应用场景 - 11 - 2）技术方案 - 12 - 3）编码实现 - 12 - A、访问数据库 - 12 - B、编写网页元素 - 13 - 一、用户的状态获取 在您开发的互动空间程序中，有时需要查询某个QQ用户或某批QQ用户的在线状态，腾讯公司为此提供了一个简便的接口，该接口是一个URL地址。根据获取单个和多个的不同，该URL地址有所不同，服务器返回的形式也有所不同。注意，该URL地址是大小写敏感的。 目前只返回在线和离线两种状态，注意，没有离开状态和隐身状态，当用户处于离开状态时，视同在线；当用户处于隐身状态时，视同离线状态。 1、获取单个用户的状态： 获取单个用户的状态的URL地址是： /getonline?Type=1qq=3621277resulttype=3 后三项您可以随意定制，具体含义为： Type项：对于获取单个用户的情况，是保留项，可以填写任意值或者不要该项 /getonline?qq=3621277resulttype=3 qq项：代表您要查询的QQ用户的号码； resulttype项：表示您希望获得的是QQ还是TM的状态，值为1代表返回的是TM类型的状态，值为3代表返回的是QQ类型的状态。 把上述URL地址拷贝到IE的地址栏，回车，返回的页面显示如下值： document.write(img src=06/qq1_offline.gif border=0 ) 可见，这个查询的返回结果是一条显示某个图片的命令，06/qq1_offline.gif就是表示图片所在的位置以及文件名，不同的图片代表了不同的状态。 根据您填写的resulttype的值不同，用不同的图片代表不同的状态，具体如下表： 表1 状态一览表 Resulttype的值 图片 文件名 代表的含义 1 tm_offline.gif TM用户离线 1 tm_online.gif TM用户在线 2 rtx_offline.gif s-buddy用户离线 2 rtx_online.gif s-buddy用户在线 3 qq1_offline.gif QQ用户离线 3 qq1_online.gif QQ用户在线 0或4 qq_offline.gif QQ用户离线 0或4 qq_online.gif QQ用户在线 下面是一段获取单个用户的在线状态的完整示例代码： html head meta http-equiv=Content-Type content=text/html; charset=gb2312 title示例网页/title /head body 这里显示的是QQ用户的状态，如果要更新，请刷新网页。 TM:3621277 的在线状态 script language=javascript src=6/getonline?type=1qq=3621277resulttype=1 /script /body /html 从上面的代码可以看出，获取状态的命令是这句话： script language=javascript src=6/getonline?Type=1qq=3621277resulttype=1 /script 服务器返回命令是： document.write(img src=06/qq1_offline.gif border=0 ) 该命令执行的结果将会在获取状态的命令的位置绘制一个图片，以代表客户的在线状态 2、获取多个用户的状态 获取多个用户状态的URL地址是： /getonline?Type=1154195734:240285461 其中Type=1是表示获取多个用户的状态，“Type=1”后面紧跟着的是您要查询的用户的QQ号码，各个号码之间必须用冒号“:”隔开，并且必须以冒号“:”结尾。 把上述URL地址拷贝到IE浏览器的地址栏中，回车，可以看到返回结果是： online[0]=0;online[1]=1;onli