mirror of
https://gitee.com/fudiwei/DotNetCore.SKIT.FlurlHttpClient.Wechat.git
synced 2025-07-18 13:26:42 +08:00
202 lines
11 KiB
C#
202 lines
11 KiB
C#
using System;
|
||
using System.Collections.Generic;
|
||
using System.Collections.ObjectModel;
|
||
using System.Linq;
|
||
using Flurl;
|
||
|
||
namespace SKIT.FlurlHttpClient.Wechat.Api
|
||
{
|
||
public static class WechatApiClientParameterExtensions
|
||
{
|
||
private const string BASE_URL_OPEN = "https://open.weixin.qq.com/";
|
||
private const string BASE_URL_MP = "https://mp.weixin.qq.com/";
|
||
|
||
/// <summary>
|
||
/// <para>生成公众号 JS-SDK `wx.config` 所需的参数字典。</para>
|
||
/// <para>REF: https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/JS-SDK.html#62 </para>
|
||
/// </summary>
|
||
/// <param name="client"></param>
|
||
/// <param name="jsapiTicket"></param>
|
||
/// <param name="url"></param>
|
||
/// <returns></returns>
|
||
public static IDictionary<string, string> GenerateParametersForJSSDKConfig(this WechatApiClient client, string jsapiTicket, string url)
|
||
{
|
||
if (client is null) throw new ArgumentNullException(nameof(client));
|
||
if (jsapiTicket is null) throw new ArgumentNullException(nameof(jsapiTicket));
|
||
if (url is null) throw new ArgumentNullException(nameof(url));
|
||
|
||
string timestamp = DateTimeOffset.Now.ToLocalTime().ToUnixTimeSeconds().ToString();
|
||
string nonce = Guid.NewGuid().ToString("N");
|
||
string sign = Utilities.SHA1Utility.Hash($"jsapi_ticket={jsapiTicket}&noncestr={nonce}×tamp={timestamp}&url={url.Split('#')[0]}").Value!.ToLower();
|
||
|
||
return new ReadOnlyDictionary<string, string>(new Dictionary<string, string>()
|
||
{
|
||
{ "appId", client.Credentials.AppId },
|
||
{ "timestamp", timestamp },
|
||
{ "nonceStr", nonce },
|
||
{ "signature", sign }
|
||
});
|
||
}
|
||
|
||
/// <summary>
|
||
/// <para>生成公众号 JS-SDK `wx.chooseInvoice` 接口所需的参数字典。</para>
|
||
/// <para>REF: https://developers.weixin.qq.com/doc/offiaccount/WeChat_Invoice/Auto-print/API_Documentation.html#_6-4-%E5%8F%91%E7%A5%A8%E7%AD%BE%E5%90%8D%E6%96%B9%E6%B3%95 </para>
|
||
/// </summary>
|
||
/// <param name="client"></param>
|
||
/// <param name="wxcardTicket"></param>
|
||
/// <returns></returns>
|
||
public static IDictionary<string, string> GenerateParametersForJSSDKChooseInvoice(this WechatApiClient client, string wxcardTicket)
|
||
{
|
||
if (client is null) throw new ArgumentNullException(nameof(client));
|
||
if (wxcardTicket is null) throw new ArgumentNullException(nameof(wxcardTicket));
|
||
|
||
string timestamp = DateTimeOffset.Now.ToLocalTime().ToUnixTimeSeconds().ToString();
|
||
string nonce = Guid.NewGuid().ToString("N");
|
||
string cardType = "INVOICE";
|
||
|
||
List<string> tmp = new List<string>(capacity: 5) { cardType, timestamp, client.Credentials.AppId, nonce, wxcardTicket };
|
||
tmp.Sort(StringComparer.Ordinal);
|
||
string cardSign = Utilities.SHA1Utility.Hash(string.Concat(tmp)).Value!.ToLower();
|
||
|
||
return new ReadOnlyDictionary<string, string>(new Dictionary<string, string>()
|
||
{
|
||
{ "timestamp", timestamp },
|
||
{ "nonceStr", nonce },
|
||
{ "signType", "SHA1" },
|
||
{ "cardType", cardType },
|
||
{ "cardSign", cardSign }
|
||
});
|
||
}
|
||
|
||
/// <summary>
|
||
/// <para>生成公众号网页授权 URL。</para>
|
||
/// <para>REF: https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html </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 WechatApiClient client, string redirectUrl, string scope, string? state = null)
|
||
{
|
||
return GenerateParameterizedUrlForConnectOAuth2Authorize(client, redirectUrl: redirectUrl, scope: scope, state: state, forcePopup: null);
|
||
}
|
||
|
||
/// <summary>
|
||
/// <para>生成公众号网页授权 URL。</para>
|
||
/// <para>REF: https://developers.weixin.qq.com/doc/offiaccount/OA_Web_Apps/Wechat_webpage_authorization.html </para>
|
||
/// </summary>
|
||
/// <param name="client"></param>
|
||
/// <param name="redirectUrl"></param>
|
||
/// <param name="scope"></param>
|
||
/// <param name="state"></param>
|
||
/// <param name="forcePopup"></param>
|
||
/// <returns></returns>
|
||
public static string GenerateParameterizedUrlForConnectOAuth2Authorize(this WechatApiClient client, string redirectUrl, string scope, string? state = null, bool? forcePopup = null)
|
||
{
|
||
return new Url(BASE_URL_OPEN)
|
||
.AppendPathSegments("connect", "oauth2", "authorize")
|
||
.SetQueryParam("appid", client.Credentials.AppId)
|
||
.SetQueryParam("redirect_uri", redirectUrl)
|
||
.SetQueryParam("response_type", "code")
|
||
.SetQueryParam("scope", scope)
|
||
.SetQueryParam("state", state)
|
||
.SetQueryParam("forcePopup", forcePopup.HasValue ? forcePopup.Value ? "true" : "false" : null)
|
||
.SetFragment("wechat_redirect")
|
||
.ToString();
|
||
}
|
||
|
||
/// <summary>
|
||
/// <para>生成代公众号网页授权 URL。</para>
|
||
/// <para>REF: https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/Before_Develop/Official_Accounts/official_account_website_authorization.html </para>
|
||
/// </summary>
|
||
/// <param name="client"></param>
|
||
/// <param name="appId"></param>
|
||
/// <param name="redirectUrl"></param>
|
||
/// <param name="scope"></param>
|
||
/// <param name="state"></param>
|
||
/// <returns></returns>
|
||
public static string GenerateParameterizedUrlForComponentConnectOAuth2Authorize(this WechatApiClient client, string appId, string redirectUrl, string scope, string? state = null)
|
||
{
|
||
return GenerateParameterizedUrlForComponentConnectOAuth2Authorize(client, appId: appId, redirectUrl: redirectUrl, scope: scope, state: state, forcePopup: null);
|
||
}
|
||
|
||
/// <summary>
|
||
/// <para>生成代公众号网页授权 URL。</para>
|
||
/// <para>REF: https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/Before_Develop/Official_Accounts/official_account_website_authorization.html </para>
|
||
/// </summary>
|
||
/// <param name="client"></param>
|
||
/// <param name="appId"></param>
|
||
/// <param name="redirectUrl"></param>
|
||
/// <param name="scope"></param>
|
||
/// <param name="state"></param>
|
||
/// <param name="forcePopup"></param>
|
||
/// <returns></returns>
|
||
public static string GenerateParameterizedUrlForComponentConnectOAuth2Authorize(this WechatApiClient client, string appId, string redirectUrl, string scope, string? state = null, bool? forcePopup = null)
|
||
{
|
||
return new Url(BASE_URL_OPEN)
|
||
.AppendPathSegments("connect", "oauth2", "authorize")
|
||
.SetQueryParam("appid", appId)
|
||
.SetQueryParam("component_appid", client.Credentials.AppId)
|
||
.SetQueryParam("redirect_uri", redirectUrl)
|
||
.SetQueryParam("response_type", "code")
|
||
.SetQueryParam("scope", scope)
|
||
.SetQueryParam("state", state)
|
||
.SetQueryParam("forcePopup", forcePopup.HasValue ? forcePopup.Value ? "true" : "false" : null)
|
||
.SetFragment("wechat_redirect")
|
||
.ToString();
|
||
}
|
||
|
||
/// <summary>
|
||
/// <para>生成公众号管理员向第三方平台授权 URL（H5 版）。</para>
|
||
/// <para>REF: https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/Before_Develop/Authorization_Process_Technical_Description.html </para>
|
||
/// </summary>
|
||
/// <param name="client"></param>
|
||
/// <param name="preAuthCode"></param>
|
||
/// <param name="redirectUrl"></param>
|
||
/// <param name="authType"></param>
|
||
/// <param name="businessAppId"></param>
|
||
/// <param name="categoryIdList"></param>
|
||
/// <returns></returns>
|
||
public static string GenerateParameterizedUrlForComponentSafeBindComponent(this WechatApiClient client, string preAuthCode, string redirectUrl, int authType = 3, string? businessAppId = null, params string[] categoryIdList)
|
||
{
|
||
return new Url(BASE_URL_OPEN)
|
||
.AppendPathSegments("wxaopen", "safe", "bindcomponent")
|
||
.SetQueryParam("action", "bindcomponent")
|
||
.SetQueryParam("no_scan", 1)
|
||
.SetQueryParam("component_appid", client.Credentials.AppId)
|
||
.SetQueryParam("pre_auth_code", preAuthCode)
|
||
.SetQueryParam("redirect_uri", redirectUrl)
|
||
.SetQueryParam("auth_type", authType)
|
||
.SetQueryParam("biz_appid", businessAppId)
|
||
.SetQueryParam("category_id_list", categoryIdList.Any() ? string.Join("|", categoryIdList) : null)
|
||
.SetFragment("wechat_redirect")
|
||
.ToString();
|
||
}
|
||
|
||
/// <summary>
|
||
/// <para>生成公众号管理员向第三方平台授权 URL（PC 版）。</para>
|
||
/// <para>REF: https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/api/Before_Develop/Authorization_Process_Technical_Description.html </para>
|
||
/// </summary>
|
||
/// <param name="client"></param>
|
||
/// <param name="preAuthCode"></param>
|
||
/// <param name="redirectUrl"></param>
|
||
/// <param name="authType"></param>
|
||
/// <param name="businessAppId"></param>
|
||
/// <param name="categoryIdList"></param>
|
||
/// <returns></returns>
|
||
public static string GenerateParameterizedUrlForComponentLoginPage(this WechatApiClient client, string preAuthCode, string redirectUrl, int authType = 3, string? businessAppId = null, params string[] categoryIdList)
|
||
{
|
||
return new Url(BASE_URL_MP)
|
||
.AppendPathSegments("cgi-bin", "componentloginpage")
|
||
.SetQueryParam("component_appid", client.Credentials.AppId)
|
||
.SetQueryParam("pre_auth_code", preAuthCode)
|
||
.SetQueryParam("redirect_uri", redirectUrl)
|
||
.SetQueryParam("auth_type", authType)
|
||
.SetQueryParam("biz_appid", businessAppId)
|
||
.SetQueryParam("category_id_list", categoryIdList.Any() ? string.Join("|", categoryIdList) : null)
|
||
.ToString();
|
||
}
|
||
}
|
||
}
|