logo资料库

api接口文档模板.doc

第1页 / 共3页
第2页 / 共3页
第3页 / 共3页
资料共3页,全文预览结束
1.接口说明
2.使用场景
3.接口调用说明
3.1请求说明
3.2输入参数说明
3.3请求示例
3.4返回参数说明
3.5返回码说明
3.6正确返回示例
3.7错误返回示例
1.接口说明 获取登录用户在 QQ 空间的信息,包括昵称、头像、性别及黄钻信息(包括黄钻 等级、是否年费黄钻等)。 2.使用场景 此接口主要用于网站使用 QQ 登录时,直接拉取用户在 QQ 空间的昵称、头像、性 别等信息,降低用户的注册成本。 3.接口调用说明 3.1 请求说明 url https://graph.qq.com/user/get_user_info 支持验证方式 oauth2.0 格式 JSON http 请求方式 GET 是否需要鉴权 需要 接口调试 点击这里测试 3.2 输入参数说明 各个参数请进行 URL 编码,编码时请遵守 RFC 1738。 (1)通用参数 -OAuth2.0 协议必须传入的通用参数,详见这里 3.3 请求示例 以 OAuth2.0 协议为例(敏感信息都用*号进行了处理,实际请求中需要替换成真 实的值): https://graph.qq.com/user/get_user_info? access_token=*************& oauth_consumer_key=12345& openid=****************& format=json
3.4 返回参数说明 参数说明 描述 ret msg nickname figureurl figureurl_1 figureurl_2 返回码 如果 ret<0,会有相应的错误信息提示,返回数据全部用 UTF-8 编码。 用户在 QQ 空间的昵称。 大小为 30×30 像素的 QQ 空间头像 URL。 大小为 50×50 像素的 QQ 空间头像 URL。 大小为 100×100 像素的 QQ 空间头像 URL。 figureurl_qq_1 大小为 40×40 像素的 QQ 头像 URL。 figureurl_qq_2 大小为 100×100 像素的 QQ 头像 URL。需要注意,不是所有 的用户都拥有 QQ 的 100x100 的头像,但 40x40 像素则是一 定会有。 gender 性别。 如果获取不到则默认返回"男" is_yellow_vip 标识用户是否为黄钻用户(0:不是;1:是)。 vip 标识用户是否为黄钻用户(0:不是;1:是) yellow_vip_level 黄钻等级 level 黄钻等级 is_yellow_year_vip 标识是否为年费黄钻用户(0:不是; 1:是) 3.5 返回码说明 0: 正确返回 其它: 失败。错误码说明详见:公共返回码说明。 3.6 正确返回示例 JSON 示例: Content-type: text/html; charset=utf-8 { "ret":0, "msg":"", "nickname":"Peter", "figureurl":"http://qzapp.qlogo.cn/qzapp/111111/942FEA70050EEAFBD4DCE 2C1FC775E56/30", "figureurl_1":"http://qzapp.qlogo.cn/qzapp/111111/942FEA70050EEAFBD4D CE2C1FC775E56/50",
"figureurl_2":"http://qzapp.qlogo.cn/qzapp/111111/942FEA70050EEAFBD4D CE2C1FC775E56/100", "figureurl_qq_1":"http://q.qlogo.cn/qqapp/100312990/DE1931D5330620DBD 07FB4A5422917B6/40", "figureurl_qq_2":"http://q.qlogo.cn/qqapp/100312990/DE1931D5330620DBD 07FB4A5422917B6/100", "gender":"男", "is_yellow_vip":"1", "vip":"1", "yellow_vip_level":"7", "level":"7", "is_yellow_year_vip":"1" } 3.7 错误返回示例 Content-type: text/html; charset=utf-8 { "ret":1002, "msg":"请先登录" }
分享到:
收藏