lsm/DotNetCore.SKIT.FlurlHttpClient.Wechat
1
0
Fork 0
mirror of https://gitee.com/fudiwei/DotNetCore.SKIT.FlurlHttpClient.Wechat.git synced 2025-09-20 02:29:40 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

feat(work): 新增获取接收的邮件相关接口

Browse Source
This commit is contained in:
fudiwei
2022-12-03 16:13:53 +08:00
parent 24d67a68bb
commit 7f87a691f3
11 changed files with 205 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
src/SKIT.FlurlHttpClient.Wechat.Work/Events/Exmail/AppEmailChangeEvent.cs Normal file
View File

@@ -0,0 +1,21 @@
namespace SKIT.FlurlHttpClient.Wechat.Work.Events
{
/// <summary>
/// <para>表示 EVENT.app_email_change 事件的数据。</para>
/// <para>REF: https://developer.work.weixin.qq.com/document/path/97506 </para>
/// </summary>
public class AppEmailChangeEvent : WechatWorkEvent, WechatWorkEvent.Serialization.IXmlSerializable
{
/// <summary>
/// 获取或设置操作类型。
/// </summary>
[System.Xml.Serialization.XmlElement("ChangeType")]
public string ActionType { get; set; } = default!;
/// <summary>
/// 获取或设置新邮件数。
/// </summary>
[System.Xml.Serialization.XmlElement("Amount")]
public int MailCount { get; set; }
}
}

40
src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinExmailExtensions.cs
View File

@@ -31,6 +31,46 @@ namespace SKIT.FlurlHttpClient.Wechat.Work
return await client.SendRequestWithJsonAsync<Models.CgibinExmailAppComposeSendResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
}
/// <summary>
/// <para>异步调用 [POST] /cgi-bin/exmail/app/get_mail_list 接口。</para>
/// <para>REF: https://developer.work.weixin.qq.com/document/path/97505 </para>
/// </summary>
/// <param name="client"></param>
/// <param name="request"></param>
/// <param name="cancellationToken"></param>
/// <returns></returns>
public static async Task<Models.CgibinExmailAppGetMailListResponse> ExecuteCgibinExmailAppGetMailListAsync(this WechatWorkClient client, Models.CgibinExmailAppGetMailListRequest request, CancellationToken cancellationToken = default)
{
if (client is null) throw new ArgumentNullException(nameof(client));
if (request is null) throw new ArgumentNullException(nameof(request));
IFlurlRequest flurlReq = client
.CreateRequest(request, HttpMethod.Post, "cgi-bin", "exmail", "app", "get_mail_list")
.SetQueryParam("access_token", request.AccessToken);
return await client.SendRequestWithJsonAsync<Models.CgibinExmailAppGetMailListResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
}
/// <summary>
/// <para>异步调用 [POST] /cgi-bin/exmail/app/read_mail 接口。</para>
/// <para>REF: https://developer.work.weixin.qq.com/document/path/97982 </para>
/// </summary>
/// <param name="client"></param>
/// <param name="request"></param>
/// <param name="cancellationToken"></param>
/// <returns></returns>
public static async Task<Models.CgibinExmailAppReadMailResponse> ExecuteCgibinExmailAppReadMailAsync(this WechatWorkClient client, Models.CgibinExmailAppReadMailRequest request, CancellationToken cancellationToken = default)
{
if (client is null) throw new ArgumentNullException(nameof(client));
if (request is null) throw new ArgumentNullException(nameof(request));
IFlurlRequest flurlReq = client
.CreateRequest(request, HttpMethod.Post, "cgi-bin", "exmail", "app", "read_mail")
.SetQueryParam("access_token", request.AccessToken);
return await client.SendRequestWithJsonAsync<Models.CgibinExmailAppReadMailResponse>(flurlReq, data: request, cancellationToken: cancellationToken);
}
#endregion
#region Group

36
src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExmail/App/CgibinExmailAppGetMailListRequest.cs Normal file
View File

@@ -0,0 +1,36 @@
namespace SKIT.FlurlHttpClient.Wechat.Work.Models
{
/// <summary>
/// <para>表示 [POST] /cgi-bin/exmail/app/get_mail_list 接口的请求。</para>
/// </summary>
public class CgibinExmailAppGetMailListRequest : WechatWorkRequest
{
/// <summary>
/// 获取或设置开始时间戳。
/// </summary>
[Newtonsoft.Json.JsonProperty("begin_time")]
[System.Text.Json.Serialization.JsonPropertyName("begin_time")]
public long? BeginTimestamp { get; set; }
/// <summary>
/// 获取或设置结束时间戳。
/// </summary>
[Newtonsoft.Json.JsonProperty("end_time")]
[System.Text.Json.Serialization.JsonPropertyName("end_time")]
public long? Endimestamp { get; set; }
/// <summary>
/// 获取或设置分页每页数量。
/// </summary>
[Newtonsoft.Json.JsonProperty("limit")]
[System.Text.Json.Serialization.JsonPropertyName("limit")]
public int? Limit { get; set; }
/// <summary>
/// 获取或设置翻页标记。
/// </summary>
[Newtonsoft.Json.JsonProperty("cursor")]
[System.Text.Json.Serialization.JsonPropertyName("cursor")]
public string? Cursor { get; set; }
}
}

44
src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExmail/App/CgibinExmailAppGetMailListResponse.cs Normal file
View File

@@ -0,0 +1,44 @@
namespace SKIT.FlurlHttpClient.Wechat.Work.Models
{
/// <summary>
/// <para>表示 [POST] /cgi-bin/exmail/app/get_mail_list 接口的响应。</para>
/// </summary>
public class CgibinExmailAppGetMailListResponse : WechatWorkResponse
{
public static class Types
{
public class Mail
{
/// <summary>
/// 获取或设置邮件 ID。
/// </summary>
[Newtonsoft.Json.JsonProperty("mail_id")]
[System.Text.Json.Serialization.JsonPropertyName("mail_id")]
public string MailId { get; set; } = default!;
}
}
/// <summary>
/// 获取或设置分组列表。
/// </summary>
[Newtonsoft.Json.JsonProperty("mail_list")]
[System.Text.Json.Serialization.JsonPropertyName("mail_list")]
public Types.Mail[] MailList { get; set; } = default!;
/// <summary>
/// 获取或设置是否还有更多数据。
/// </summary>
[Newtonsoft.Json.JsonProperty("has_more")]
[Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.NumericalBooleanConverter))]
[System.Text.Json.Serialization.JsonPropertyName("has_more")]
[System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Converters.NumericalBooleanConverter))]
public bool HasMore { get; set; }
/// <summary>
/// 获取或设置翻页标记。
/// </summary>
[Newtonsoft.Json.JsonProperty("next_cursor")]
[System.Text.Json.Serialization.JsonPropertyName("next_cursor")]
public string? NextCursor { get; set; }
}
}

15
src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExmail/App/CgibinExmailAppReadMailRequest.cs Normal file
View File

@@ -0,0 +1,15 @@
namespace SKIT.FlurlHttpClient.Wechat.Work.Models
{
/// <summary>
/// <para>表示 [POST] /cgi-bin/exmail/app/read_mail 接口的请求。</para>
/// </summary>
public class CgibinExmailAppReadMailRequest : WechatWorkRequest
{
/// <summary>
/// 获取或设置邮件 ID。
/// </summary>
[Newtonsoft.Json.JsonProperty("mail_id")]
[System.Text.Json.Serialization.JsonPropertyName("mail_id")]
public string MailId { get; set; } = string.Empty;
}
}

15
src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExmail/App/CgibinExmailAppReadMailResponse.cs Normal file
View File

@@ -0,0 +1,15 @@
namespace SKIT.FlurlHttpClient.Wechat.Work.Models
{
/// <summary>
/// <para>表示 [POST] /cgi-bin/exmail/app/read_mail 接口的响应。</para>
/// </summary>
public class CgibinExmailAppReadMailResponse : WechatWorkResponse
{
/// <summary>
/// 获取或设置邮件 EML 内容。
/// </summary>
[Newtonsoft.Json.JsonProperty("mail_data")]
[System.Text.Json.Serialization.JsonPropertyName("mail_data")]
public string MailData { get; set; } = default!;
}
}

9
test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/EventSamples/Exmail/AppEmailChangeEvent.xml Normal file
View File

@@ -0,0 +1,9 @@
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[sys]]></FromUserName>
<CreateTime>1668831860</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[app_email_change]]></Event>
<ChangeType><![CDATA[receive_email]]></ChangeType>
<Amount><![CDATA[2]]></Amount>
</xml>

6
test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExmail/App/CgibinExmailAppGetMailListRequest.json Normal file
View File

@@ -0,0 +1,6 @@
{
"begin_time": 1668441600,
"end_time": 1668527999,
"cursor": "CURSOR",
"limit": 100
}

11
test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExmail/App/CgibinExmailAppGetMailListResponse.json Normal file
View File

@@ -0,0 +1,11 @@
{
"errcode": 0,
"errmsg": "ok",
"next_cursor": "NEXT_CURSOR",
"has_more": 0,
"mail_list": [
{
"mail_id": "MAIL_ID"
}
]
}

3
test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExmail/App/CgibinExmailAppReadMailRequest.json Normal file
View File

@@ -0,0 +1,3 @@
{
"mail_id": "MAIL_ID"
}

5
test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExmail/App/CgibinExmailAppReadMailResponse.json Normal file
View File

@@ -0,0 +1,5 @@
{
"errcode": 0,
"errmsg": "ok",
"mail_data": "MAIL_DATA"
}