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

QQ 空间活动平台前后端交互文档 QQ 空间对外合作开发组腾讯公司 Date(*)Ver. Date(*) Ver. Author Status –Description 24 Sept 2008 1.0 Spencer Liang Create 03 June 2009 1.1 Dio Zhang 新增异常码列表 新增接口说明: 取好友活动信息接口 免费投票接口 付费 投票接口 投票预检查接口 投票粉丝接口 QQ 空间挂件接口 批量取昵称接口 编辑资料接口 编辑资料预检查接口 修改接口说明: 免费注册接口 用户列表数据 Tencent 腾讯 Page 2 /24 目录 简介 5 通用输出控制参数 5 通用异常处理 5 身份验证 6 免费注册接口 6 接口地址 6 参数说明 6 返回结果 6 调用示例 7 注册预检查接口 7 接口地址 7 参数说明 8 返回结果 8 取用户个人资料数据接口 8 接口地址 8 参数说明 8 返回结果 8 登录态检查接口 8 接口地址 8 参数说明 8 返回结果 8 取好友活动信息接口 9 接口地址 9 参数说明 9 返回结果 9 调用示例 9 QQ 空间挂件接口 9 接口地址 9 参数说明 9 返回结果 10 批量取昵称接口 10 接口地址 10 参数说明 10 返回结果 10 编辑资料接口 10 接口地址 10 参数说明 10 返回结果 11 编辑资料预检查接口 11 接口地址 11 参数说明 12 返回结果 12 免费投票接口 12 接口地址 12 参数说明 12 返回结果 12 付费投票接口 13 接口地址 13 参数说明 13 返回结果 13 Tencent 腾讯 Page 3 / 24 投票预检查接口 14 接口地址 14 参数说明 14 返回结果 14 投票粉丝接口 15 接口地址 15 参数说明 15 返回结果 15 首页列表数据 15 接口描述 16 接口地址 16 参数说明 16 返回结果 16 推荐数据 16 接口描述 17 接口地址 17 返回结果 17 示例数据 17 用户列表数据 18 接口描述 18 接口地址 18 返回结果 18 示例数据 19 其他接口 19 接口描述 20 接口地址 20 参数说明 20 返回结果 20 21.5 示例 20 异常码列表 20 Tencent 腾讯 Page 4 / 24 简介 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=s criptuincode 返回： scriptdocument.domain= ” ”;MyCallback($obj)/script 其中$obj 是 unicode 编码的 json 字符串 通用异常处理 当平台的 PHP 脚本遇到异常或错误时，会返回一个统一的错误格式数据，示例如下： 当设置了 callback 参数时： JsonCallback({error:{type:4103,msg:QQ 号格式有错,errcode:4103}}); 以树型显示的 JSON 数据： 当没有 callback 参数时： {err:4103,msg:QQ 号格式有错} 以树型显示的 JSON 数据： Tencent 腾讯 Page 5 /24 其中 err 为错