feat(work): 新增生成企业号网页授权和扫码授权 URL 的扩展方法

This commit is contained in:
Fu Diwei
2022-01-10 12:47:19 +08:00
parent 7677588e22
commit 319cfaf392

View File

@@ -1,24 +1,14 @@
using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using System.Linq;
using System.Net.Http;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
using System.Web;
using Flurl;
using Flurl.Http;
namespace SKIT.FlurlHttpClient.Wechat.Work
{
/// <summary>
/// 为 <see cref="WechatWorkClient"/> 提供客户端调起 JS-SDK 签名的扩展方法。
/// </summary>
public static class WechatWorkClientParameterExtensions
{
/// <summary>
/// <para>生成客户端 JS-SDK `wx.config` 所需的参数。</para>
/// <para>生成企业号 JS-SDK `wx.config` 所需的参数字典。</para>
/// <para>REF: https://open.work.weixin.qq.com/api/doc/90000/90136/90506 </para>
/// <para>REF: https://open.work.weixin.qq.com/api/doc/90001/90144/90539 </para>
/// <para>REF: https://open.work.weixin.qq.com/api/doc/90002/90152/90777 </para>
@@ -27,7 +17,7 @@ namespace SKIT.FlurlHttpClient.Wechat.Work
/// <param name="jsapiTicket"></param>
/// <param name="url"></param>
/// <returns></returns>
public static IDictionary<string, string> GenerateParametersForJssdkConfigRequest(this WechatWorkClient client, string jsapiTicket, string url)
public static IDictionary<string, string> GenerateParametersForJSSDKConfig(this WechatWorkClient client, string jsapiTicket, string url)
{
if (client is null) throw new ArgumentNullException(nameof(client));
if (jsapiTicket is null) throw new ArgumentNullException(nameof(jsapiTicket));
@@ -47,7 +37,7 @@ namespace SKIT.FlurlHttpClient.Wechat.Work
}
/// <summary>
/// <para>生成客户端 JS-SDK `wx.agentConfig` 所需的参数。</para>
/// <para>生成企业号 JS-SDK `wx.agentConfig` 所需的参数字典。</para>
/// <para>REF: https://open.work.weixin.qq.com/api/doc/90000/90136/90506 </para>
/// <para>REF: https://open.work.weixin.qq.com/api/doc/90001/90144/90539 </para>
/// <para>REF: https://open.work.weixin.qq.com/api/doc/90002/90152/90777 </para>
@@ -56,7 +46,7 @@ namespace SKIT.FlurlHttpClient.Wechat.Work
/// <param name="jsapiTicket"></param>
/// <param name="url"></param>
/// <returns></returns>
public static IDictionary<string, string> GenerateParametersForJssdkAgentConfigRequest(this WechatWorkClient client, string jsapiTicket, string url)
public static IDictionary<string, string> GenerateParametersForJSSDKAgentConfig(this WechatWorkClient client, string jsapiTicket, string url)
{
if (client is null) throw new ArgumentNullException(nameof(client));
if (jsapiTicket is null) throw new ArgumentNullException(nameof(jsapiTicket));
@@ -75,5 +65,52 @@ namespace SKIT.FlurlHttpClient.Wechat.Work
{ "signature", sign }
});
}
/// <summary>
/// <para>生成企业号网页授权 URL。</para>
/// <para>REF: https://open.work.weixin.qq.com/api/doc/90000/90135/91022 </para>
/// <para>REF: https://open.work.weixin.qq.com/api/doc/90001/90143/91120 </para>
/// </summary>
/// <param name="client"></param>
/// <param name="redirectUrl"></param>
/// <param name="scope"></param>
/// <param name="state"></param>
/// <returns></returns>
public static string GenerateParameterizedUrlForConnectOAuth2Authorize(this WechatWorkClient client, string redirectUrl, string scope, string? state = null)
{
return new Url("https://open.weixin.qq.com")
.AppendPathSegments("connect", "oauth2", "authorize")
.SetQueryParam("appid", string.IsNullOrEmpty(client.Credentials.SuiteId) ? client.Credentials.CorpId : client.Credentials.SuiteId)
.SetQueryParam("redirect_uri", redirectUrl)
.SetQueryParam("response_type", "code")
.SetQueryParam("scope", scope)
.SetQueryParam("state", state)
.SetFragment("wechat_redirect")
.ToString();
}
/// <summary>
/// <para>生成企业号扫码授权 URL。</para>
/// <para>REF: https://open.work.weixin.qq.com/api/doc/90000/90135/91019 </para>
/// <para>REF: https://open.work.weixin.qq.com/api/doc/90001/90143/91124 </para>
/// </summary>
/// <param name="client"></param>
/// <param name="redirectUrl"></param>
/// <param name="state"></param>
/// <param name="language"></param>
/// <param name="userType"></param>
/// <returns></returns>
public static string GenerateParameterizedUrlForSSOQrcodeConnectAuthorize(this WechatWorkClient client, string redirectUrl, string? state = null, string? language = null, string? userType = null)
{
return new Url("https://open.work.weixin.qq.com")
.AppendPathSegments("wwopen", "sso", "qrConnect")
.SetQueryParam("appid", client.Credentials.CorpId)
.SetQueryParam("agentid", client.Credentials.AgentId)
.SetQueryParam("redirect_uri", redirectUrl)
.SetQueryParam("state", state)
.SetQueryParam("lang", language)
.SetQueryParam("usertype", userType)
.ToString();
}
}
}