网站接入QQ登录注意事项

Posted chenxin.dm

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了网站接入QQ登录注意事项相关的知识,希望对你有一定的参考价值。

本文主要跟大家分享下我的个人博客 陈新的个人博客 站点在接入QQ登录的过程中所遇到的一些问题,在这里分享给大家,方便准备想接入QQ登录功能的或者接入过程中正遇到一些问题的小伙伴快速解决问题,避免踩我已经踩过的坑。

一、跳转到QQ登录授权页面的地址

跳转到QQ登录授权页面的地址应该用:https://graph.qq.com/oauth2.0/authorize ,而不是用https://graph.qq.com/oauth2.0/show 这个前缀,后者这个是PC端的QQ授权页面,如果你的网站跳转到的是后面这个地址,将会导致手机端使用的QQ登录授权页面也是PC端的,这样手机端就无法使用QQ一键登录功能了,正确的应该使用前者这个地址,腾讯会自动判断跳转到PC端还是手机端的QQ登录授权页面。

手机端的QQ登录界面应该类似于如下:

 

二、QQ授权页面传参

不要往QQ授权页面的地址中传入参数display=pc,这个参数告诉QQ说我当前正在PC端进行QQ一件登录,因此也会造成和上述一样的问题。

以上就是本人在对接QQ登录过程中遇到的一些问题,下面附上本人的个人站中用到的QQ登录的代码,方便大家快速集成QQ登录功能,本人的个人站使用asp.net core 3.1.

接口对接代码

using BlogSys.Models;
using BlogSys.Models.QQLogin;
using Microsoft.Extensions.Logging;
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Http;
using System.Text.Json;
using System.Text.Json.Serialization;
using System.Threading.Tasks;

namespace BlogSys.Services
{
    /// <summary>
    /// QQ登录功能。
    /// </summary>
    public class QQLoginService
    {
        const string callbackUrl = "这里填写你提供给腾讯的你的网站的回调地址";
        const string clientId = "这里填写网站应用ID";
        const string clientSecret = "这里填写网站应用秘钥";
        HttpClient client;
        ILogger<QQLoginService> logger;
        public QQLoginService(HttpClient client, ILogger<QQLoginService> logger)
        {
            this.client = client;
            this.logger = logger;
        }
        /// <summary>
        /// QQ 登录
        /// </summary>
        /// <param name="code"></param>
        /// <param name="redirect_url"></param>
        /// <returns></returns>
        public async Task<QQUserInfo> Login(string code)
        {
            QQUserInfo userInfo = null;
            QQApiAccessToken accessToken = await this.GetAccessToken(code, callbackUrl);
            QQOpenIDInfo openIDInfo = await this.GetOpenID(accessToken.access_token);
            userInfo = await this.GetUserInfo(accessToken.access_token, clientId, openIDInfo.openid);
            userInfo.OpenID = openIDInfo.openid;
            return userInfo;
        }
        //根据不同页面点击QQ登录时,生成QQ授权登录页面地址,方面登录前在哪个页面,登录后就跳回哪个页面。
        public string GetQQLoginUrl(string redirectUrl)
        {
            return $"https://graph.qq.com/oauth2.0/authorize?which=Login&response_type=code&redirect_uri={callbackUrl}&client_id={clientId}&state={redirectUrl}";
        }
        /// <summary>
        /// 获取API访问Token.
        /// </summary>
        /// <param name="code"></param>
        /// <param name="redirect_uri"></param>
        /// <param name="fmt"></param>
        /// <returns></returns>
        public async Task<QQApiAccessToken> GetAccessToken(string code, string redirect_uri, string fmt = "json")
        {
            string grant_type = "authorization_code";
            string apiUrl = $"/oauth2.0/token?grant_type={grant_type}&client_id={clientId}&client_secret={clientSecret}&code={code}&redirect_uri={redirect_uri}&fmt={fmt}";
            HttpResponseMessage responseMessage = await client.SendAsync(new HttpRequestMessage(HttpMethod.Get, apiUrl));
            if (!responseMessage.IsSuccessStatusCode)
                return null;
            string resultStr = await responseMessage.Content.ReadAsStringAsync();
            if (string.IsNullOrWhiteSpace(resultStr))
            {
                return null;
            }
            return JsonSerializer.Deserialize<QQApiAccessToken>(resultStr);
        }
        /// <summary>
        /// 根据刷新Token获取访问Token.
        /// </summary>
        /// <param name="refresh_token"></param>
        /// <param name="fmt"></param>
        /// <returns></returns>
        public async Task<QQApiAccessToken> GetAccessTokenByRefreshToken(string refresh_token, string fmt = "json")
        {
            string grant_type = "refresh_token";
            string apiUrl = $"/oauth2.0/token?grant_type={grant_type}&client_id={clientId}&client_secret={clientSecret}&refresh_token={refresh_token}&fmt={fmt}";
            HttpResponseMessage responseMessage = await client.SendAsync(new HttpRequestMessage(HttpMethod.Get, apiUrl));
            if (!responseMessage.IsSuccessStatusCode)
                return null;
            string resultStr = await responseMessage.Content.ReadAsStringAsync();
            if (string.IsNullOrWhiteSpace(resultStr))
            {
                return null;
            }
            return JsonSerializer.Deserialize<QQApiAccessToken>(resultStr);
        }
        /// <summary>
        /// 获取QQ OpenId信息
        /// </summary>
        /// <param name="access_token">API访问Token</param>
        /// <param name="fmt"></param>
        /// <returns></returns>
        public async Task<QQOpenIDInfo> GetOpenID(string access_token, string fmt = "json")
        {
            string apiUrl = $"oauth2.0/me?access_token={access_token}&fmt={fmt}";
            HttpResponseMessage responseMessage = await this.client.SendAsync(new HttpRequestMessage(HttpMethod.Get, apiUrl));
            if (!responseMessage.IsSuccessStatusCode)
                return null;
            string apiResult = await responseMessage.Content.ReadAsStringAsync();
            if (string.IsNullOrWhiteSpace(apiResult))
                return null;
            return JsonSerializer.Deserialize<QQOpenIDInfo>(apiResult);
        }
        /// <summary>
        /// 获取用户信息
        /// </summary>
        /// <param name="access_token"></param>
        /// <param name="oauth_consumer_key"></param>
        /// <param name="openid"></param>
        /// <returns></returns>
        public async Task<QQUserInfo> GetUserInfo(string access_token, string oauth_consumer_key, string openid)
        {
            string apiUrl = $"user/get_user_info?access_token={access_token}&oauth_consumer_key={oauth_consumer_key}&openid={openid}";
            HttpResponseMessage responseMessage = await this.client.SendAsync(new HttpRequestMessage(HttpMethod.Get, apiUrl));
            if (!responseMessage.IsSuccessStatusCode)
                return null;
            string apiResult = await responseMessage.Content.ReadAsStringAsync();
            if (string.IsNullOrWhiteSpace(apiResult))
                return null;
            return JsonSerializer.Deserialize<QQUserInfo>(apiResult);
        }
    }
}

 

QQ登录相关实体模型

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace BlogSys.Models.QQLogin
{
    public class QQUserInfo
    {
        /// <summary>
        /// 返回码 0:成功 其他:失败
        /// </summary>
        public int ret { get; set; }
        /// <summary>
        /// 如果ret<0,会有相应的错误信息提示,返回数据全部用UTF-8编码。
        /// </summary>
        public string msg { get; set; }
        /// <summary>
        /// 用户在QQ空间的昵称。
        /// </summary>
        public string nickname { get; set; }
        /// <summary>
        /// 大小为30×30像素的QQ空间头像URL。
        /// </summary>
        public string figureurl { get; set; }
        /// <summary>
        /// 大小为50×50像素的QQ空间头像URL。
        /// </summary>
        public string figureurl_1 { get; set; }
        /// <summary>
        /// 大小为100×100像素的QQ空间头像URL。
        /// </summary>
        public string figureurl_2 { get; set; }
        /// <summary>
        /// 大小为40×40像素的QQ头像URL。
        /// </summary>
        public string figureurl_qq_1 { get; set; }
        /// <summary>
        /// 大小为100×100像素的QQ头像URL。
        /// 需要注意,不是所有的用户都拥有QQ的100x100的头像,但40x40像素则是一定会有。
        /// </summary>
        public string figureurl_qq_2 { get; set; }
        /// <summary>
        /// 性别。 如果获取不到则默认返回"男"
        /// </summary>
        public string gender { get; set; }
        public string is_yellow_vip { get; set; }
        public string vip { get; set; }
        public string yellow_vip_level { get; set; }
        public string level { get; set; }
        public string is_yellow_year_vip { get; set; }
        /// <summary>
        /// QQ用户唯一标识。
        /// </summary>
        public string OpenID { get; set; }
    }
}
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace BlogSys.Models.QQLogin
{
    public class QQApiAccessToken
    {
        /// <summary>
        /// 授权令牌,Access_Token。
        /// </summary>
        public string access_token { get; set; }
        /// <summary>
        /// 该access token的有效期,单位为秒。
        /// </summary>
        public string expires_in { get; set; }
        /// <summary>
        /// 在授权自动续期步骤中,获取新的Access_Token时需要提供的参数。
        /// 注:refresh_token仅一次有效
        /// </summary>
        public string refresh_token { get; set; }
    }
}

 

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace BlogSys.Models.QQLogin
{
    public class QQOpenIDInfo
    {
        public string client_id { get; set; }
        public string openid { get; set; }
    }
}

 以下代码为asp.net core 中注入HttpClient 的部分。

public void ConfigureServices(IServiceCollection services)
{
	services.AddHttpClient<QQLoginService>(httpClient =>
	{
		httpClient.BaseAddress = new Uri("https://graph.qq.com");
	});
   
}

 

好了,以上就是我今天要和小伙伴们分享的内容,如果你在对接QQ登录过程中遇到了一些困惑,那么请登录我的  个人博客 并在我的这篇文章中留言,因为我的个人博客收到用户留言,会立刻通知我这边,以便我快速帮你们解答。

337901356

以上是关于网站接入QQ登录注意事项的主要内容,如果未能解决你的问题,请参考以下文章

网站接入QQ登录

利用JS_SDK实现QQ第三方登录

springboot网站应用使用第三方qq登录

springboot网站应用使用第三方qq登录

springboot网站应用使用第三方qq登录

第三方登录(QQ登录)开发流程