QQ空间活动平台前后端交互文档.doc

QQ空间活动平台前后端交互文档 QQ空间 对外合作开发组 腾讯公司  Revision History Date(*) Ver. Author Status – Description 24 Sept 2008 1.0 Spencer Liang Create 03 June 2009 1.1 Dio Zhang 新增异常码列表 新增接口说明: 取好友活动信息接口 免费投票接口 付费 投票接口 投票预检查接口 投票粉丝接口 QQ空间挂件接口 批量取昵称接口 编辑资料接口 编辑资料预检查接口 修改接口说明: 免费注册接口 用户列表数据  目录 1 简介 5 2 通用输出控制参数 5 3 通用异常处理 5 4 身份验证 6 5 免费注册接口 6 5.1 接口地址 6 5.2 参数说明 6 5.3 返回结果 6 5.4 调用示例 7 6 注册预检查接口 7 6.1 接口地址 7 6.2 参数说明 8 6.3 返回结果 8 7 取用户个人资料数据接口 8 7.1 接口地址 8 7.2 参数说明 8 7.3 返回结果 8 8 登录态检查接口 8 8.1 接口地址 8 8.2 参数说明 8 8.3 返回结果 8 9 取好友活动信息接口 9 9.1 接口地址 9 9.2 参数说明 9 9.3 返回结果 9 9.4 调用示例 9 10 QQ空间挂件接口 9 10.1 接口地址 9 10.2 参数说明 9 10.3 返回结果 10 11 批量取昵称接口 10 11.1 接口地址 10 11.2 参数说明 10 11.3 返回结果 10 12 编辑资料接口 10 12.1 接口地址 10 12.2 参数说明 10 12.3 返回结果 11 13 编辑资料预检查接口 11 13.1 接口地址 11 13.2 参数说明 12 13.3 返回结果 12 14 免费投票接口 12 14.1 接口地址 12 14.2 参数说明 12 14.3 返回结果 12 15 付费投票接口 13 15.1 接口地址 13 15.2 参数说明 13 15.3 返回结果 13 16 投票预检查接口 14 16.1 接口地址 14 16.2 参数说明 14 16.3 返回结果 14 17 投票粉丝接口 15 17.1 接口地址 15 17.2 参数说明 15 17.3 返回结果 15 18 首页列表数据 15 18.1 接口描述 16 18.2 接口地址 16 18.3 参数说明 16 18.4 返回结果 16 19 推荐数据 16 19.1 接口描述 17 19.2 接口地址 17 19.3 返回结果 17 19.4 示例数据 17 20 用户列表数据 18 20.1 接口描述 18 20.2 接口地址 18 20.3 返回结果 18 20.4 示例数据 19 21 其他接口 19 21.1 接口描述 20 21.2 接口地址 20 21.3 参数说明 20 21.4 返回结果 20 21.5 示例 20 22 异常码列表 20 简介 QQ空间活动平台是对外合作开发组开发出来的用于举办线上活动的一个平台。典型应用是各类选秀活动，如亚洲小姐网络赛区选举。 平台已包括用户注册，资料修改，投票，粉丝列表，用户个人主页，选手列表，首页推荐，排行榜等功能，还可以通过插件的方式扩展开发出特定的功能。 平台对数据的处理分成两大类型：一类是PHP脚本，用于写操作如注册，资料修改，投票及实时数据显示；另一类是JSON格式的静态js文件，由平台根据设定定时生成各种数据。 通用输出控制参数 以下参数可用于活动平台的所有PHP脚本，用于控制返回的JSON数据的格式。 参数名 说明 参数值 callback 回调函数 JavaScript回调函数名 默认值为JsonCallback domain JavaScript运行环境域名 默认值为，该值必须允许域名的白名单内，白名单在平台内设置。 script 是否加上script标签 只要设置该参数，不管值如何，均加上script标签 unicode 是否使用UNICODE编码输出 只要设置该参数，不管值如何，均使用UNICODE编码输出 例如：/user/profile.php?act_id=10029qq=12345callback=MyCallbackdomain=scriptuincode 返回： scriptdocument.domain=””;MyCallback($obj)/script 其中$obj是unicode编码的json字符串 通用异常处理 当平台的PHP脚本遇到异常或错误时，会返回一个统一的错误格式数据，示例如下： 当设置了callback参数时： JsonCallback({error:{ty