diff --git a/src/SKIT.FlurlHttpClient.Wechat.Api/Extensions/WechatApiClientEventExtensions.cs b/src/SKIT.FlurlHttpClient.Wechat.Api/Extensions/WechatApiClientEventExtensions.cs index ab4a749c..48863d34 100644 --- a/src/SKIT.FlurlHttpClient.Wechat.Api/Extensions/WechatApiClientEventExtensions.cs +++ b/src/SKIT.FlurlHttpClient.Wechat.Api/Extensions/WechatApiClientEventExtensions.cs @@ -33,7 +33,7 @@ namespace SKIT.FlurlHttpClient.Wechat.Api where TEvent : WechatApiEvent { if (client == null) throw new ArgumentNullException(nameof(client)); - if (string.IsNullOrEmpty(callbackJson)) throw new ArgumentNullException(callbackJson); + if (callbackJson == null) throw new ArgumentNullException(callbackJson); try { @@ -62,7 +62,7 @@ namespace SKIT.FlurlHttpClient.Wechat.Api where TEvent : WechatApiEvent { if (client == null) throw new ArgumentNullException(nameof(client)); - if (string.IsNullOrEmpty(callbackXml)) throw new ArgumentNullException(callbackXml); + if (callbackXml == null) throw new ArgumentNullException(callbackXml); try { @@ -249,9 +249,9 @@ namespace SKIT.FlurlHttpClient.Wechat.Api /// REF: https://developers.weixin.qq.com/doc/offiaccount/Basic_Information/Access_Overview.html /// /// - /// 微信回调通知中的 timestamp 字段。 - /// 微信回调通知中的 nonce 字段。 - /// 微信回调通知中的 signature 字段。 + /// 微信回调通知中的 "timestamp" 查询参数。 + /// 微信回调通知中的 "nonce" 查询参数。 + /// 微信回调通知中的 "signature" 查询参数。 /// public static bool VerifyEventSignatureForEcho(this WechatApiClient client, string callbackTimestamp, string callbackNonce, string callbackSignature) { @@ -266,14 +266,14 @@ namespace SKIT.FlurlHttpClient.Wechat.Api } /// - /// 验证回调通知事件签名。 + /// 验证回调通知事件签名(仅安全模式)。 /// REF: https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Message_encryption_and_decryption_instructions.html /// /// - /// 微信回调通知中的 timestamp 字段。 - /// 微信回调通知中的 nonce 字段。 + /// 微信回调通知中的 "timestamp" 查询参数。 + /// 微信回调通知中的 "nonce" 查询参数。 /// 微信回调通知中请求正文(JSON 格式)。 - /// 微信回调通知中的 msg_signature 字段。 + /// 微信回调通知中的 "msg_signature" 查询参数。 /// public static bool VerifyEventSignatureFromJson(this WechatApiClient client, string callbackTimestamp, string callbackNonce, string callbackJson, string callbackSignature) { @@ -298,14 +298,14 @@ namespace SKIT.FlurlHttpClient.Wechat.Api } /// - /// 验证回调通知事件签名。 + /// 验证回调通知事件签名(仅安全模式)。 /// REF: https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Message_encryption_and_decryption_instructions.html /// /// - /// 微信回调通知中的 timestamp 字段。 - /// 微信回调通知中的 nonce 字段。 + /// 微信回调通知中的 "timestamp" 查询参数。 + /// 微信回调通知中的 "nonce" 查询参数。 /// 微信回调通知中请求正文(XML 格式)。 - /// 微信回调通知中的 msg_signature 字段。 + /// 微信回调通知中的 "msg_signature" 查询参数。 /// public static bool VerifyEventSignatureFromXml(this WechatApiClient client, string callbackTimestamp, string callbackNonce, string callbackXml, string callbackSignature) { diff --git a/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Extensions/WechatTenpayClientEventVerificationExtensions.cs b/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Extensions/WechatTenpayClientEventVerificationExtensions.cs index 64260abb..fb37abdd 100644 --- a/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Extensions/WechatTenpayClientEventVerificationExtensions.cs +++ b/src/SKIT.FlurlHttpClient.Wechat.TenpayV3/Extensions/WechatTenpayClientEventVerificationExtensions.cs @@ -13,11 +13,11 @@ namespace SKIT.FlurlHttpClient.Wechat.TenpayV3 /// REF: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/wechatpay/wechatpay4_1.shtml /// /// - /// 微信回调通知中的 Wechatpay-Timestamp 字段。 - /// 微信回调通知中的 Wechatpay-Nonce 字段。 + /// 微信回调通知中的 "Wechatpay-Timestamp" 请求标头。 + /// 微信回调通知中的 "Wechatpay-Nonce" 请求标头。 /// 微信回调通知中请求正文。 - /// 微信回调通知中的 Wechatpay-Signature 字段。 - /// 微信回调通知中的 Wechatpay-Serial 字段。 + /// 微信回调通知中的 "Wechatpay-Signature" 请求标头。 + /// 微信回调通知中的 "Wechatpay-Serial" 请求标头。 /// public static bool VerifyEventSignature(this WechatTenpayClient client, string callbackTimestamp, string callbackNonce, string callbackBody, string callbackSignature, string callbackSerialNumber) { @@ -38,12 +38,12 @@ namespace SKIT.FlurlHttpClient.Wechat.TenpayV3 /// REF: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/wechatpay/wechatpay4_1.shtml /// /// - /// 微信回调通知中的 Wechatpay-Timestamp 字段。 - /// 微信回调通知中的 Wechatpay-Nonce 字段。 + /// 微信回调通知中的 "Wechatpay-Timestamp" 请求标头。 + /// 微信回调通知中的 "Wechatpay-Nonce" 请求标头。 /// 微信回调通知中请求正文。 - /// 微信回调通知中的 Wechatpay-Signature 字段。 - /// 微信回调通知中的 Wechatpay-Signature-Type 字段。 - /// 微信回调通知中的 Wechatpay-Serial 字段。 + /// 微信回调通知中的 "Wechatpay-Signature" 请求标头。 + /// 微信回调通知中的 "Wechatpay-Signature-Type" 请求标头。 + /// 微信回调通知中的 "Wechatpay-Serial" 请求标头。 /// public static bool VerifyEventSignature(this WechatTenpayClient client, string callbackTimestamp, string callbackNonce, string callbackBody, string callbackSignature, string callbackSignatureType, string callbackSerialNumber) { @@ -65,11 +65,11 @@ namespace SKIT.FlurlHttpClient.Wechat.TenpayV3 /// REF: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/wechatpay/wechatpay4_1.shtml /// /// - /// 微信回调通知中的 Wechatpay-Timestamp 字段。 - /// 微信回调通知中的 Wechatpay-Nonce 字段。 + /// 微信回调通知中的 "Wechatpay-Timestamp" 请求标头。 + /// 微信回调通知中的 "Wechatpay-Nonce" 请求标头。 /// 微信回调通知中请求正文。 - /// 微信回调通知中的 Wechatpay-Signature 字段。 - /// 微信回调通知中的 Wechatpay-Serial 字段。 + /// 微信回调通知中的 "Wechatpay-Signature" 请求标头。 + /// 微信回调通知中的 "Wechatpay-Serial" 请求标头。 /// /// public static bool VerifyEventSignature(this WechatTenpayClient client, string callbackTimestamp, string callbackNonce, string callbackBody, string callbackSignature, string callbackSerialNumber, out Exception? error) @@ -92,12 +92,12 @@ namespace SKIT.FlurlHttpClient.Wechat.TenpayV3 /// REF: https://pay.weixin.qq.com/wiki/doc/apiv3_partner/wechatpay/wechatpay4_1.shtml /// /// - /// 微信回调通知中的 Wechatpay-Timestamp 字段。 - /// 微信回调通知中的 Wechatpay-Nonce 字段。 + /// 微信回调通知中的 "Wechatpay-Timestamp" 请求标头。 + /// 微信回调通知中的 "Wechatpay-Nonce" 请求标头。 /// 微信回调通知中请求正文。 - /// 微信回调通知中的 Wechatpay-Signature 字段。 - /// 微信回调通知中的 Wechatpay-Signature-Type 字段。 - /// 微信回调通知中的 Wechatpay-Serial 字段。 + /// 微信回调通知中的 "Wechatpay-Signature" 请求标头。 + /// 微信回调通知中的 "Wechatpay-Signature-Type" 请求标头。 + /// 微信回调通知中的 "Wechatpay-Serial" 请求标头。 /// /// public static bool VerifyEventSignature(this WechatTenpayClient client, string callbackTimestamp, string callbackNonce, string callbackBody, string callbackSignature, string callbackSignatureType, string callbackSerialNumber, out Exception? error) diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientEventExtensions.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientEventExtensions.cs index 4d91b560..760ed4a6 100644 --- a/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientEventExtensions.cs +++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientEventExtensions.cs @@ -235,10 +235,10 @@ namespace SKIT.FlurlHttpClient.Wechat.Work /// REF: https://developer.work.weixin.qq.com/document/path/91148 /// /// - /// 微信回调通知中的 timestamp 字段。 - /// 微信回调通知中的 nonce 字段。 - /// 微信回调通知中的 echostr 字段。 - /// 微信回调通知中的 msg_signature 字段。 + /// 微信回调通知中的 "timestamp" 查询参数。 + /// 微信回调通知中的 "nonce" 查询参数。 + /// 微信回调通知中的 "echostr" 查询参数。 + /// 微信回调通知中的 "msg_signature" 查询参数。 /// /// public static bool VerifyEventSignatureForEcho(this WechatWorkClient client, string callbackTimestamp, string callbackNonce, string callbackEcho, string callbackSignature, out string? replyEcho) @@ -278,10 +278,10 @@ namespace SKIT.FlurlHttpClient.Wechat.Work /// REF: https://developer.work.weixin.qq.com/document/path/91148 /// /// - /// 微信回调通知中的 timestamp 字段。 - /// 微信回调通知中的 nonce 字段。 + /// 微信回调通知中的 "timestamp" 查询参数。 + /// 微信回调通知中的 "nonce" 查询参数。 /// 微信回调通知中请求正文(JSON 格式)。 - /// 微信回调通知中的 msg_signature 字段。 + /// 微信回调通知中的 "msg_signature" 查询参数。 /// public static bool VerifyEventSignatureFromJson(this WechatWorkClient client, string callbackTimestamp, string callbackNonce, string callbackJson, string callbackSignature) { @@ -312,10 +312,10 @@ namespace SKIT.FlurlHttpClient.Wechat.Work /// REF: https://developer.work.weixin.qq.com/document/path/91148 /// /// - /// 微信回调通知中的 timestamp 字段。 - /// 微信回调通知中的 nonce 字段。 + /// 微信回调通知中的 "timestamp" 查询参数。 + /// 微信回调通知中的 "nonce" 查询参数。 /// 微信回调通知中请求正文(XML 格式)。 - /// 微信回调通知中的 msg_signature 字段。 + /// 微信回调通知中的 "msg_signature" 查询参数。 /// public static bool VerifyEventSignatureFromXml(this WechatWorkClient client, string callbackTimestamp, string callbackNonce, string callbackXml, string callbackSignature) {