From 9a674f7c7f212f58dd6d14a8f1b19a8236015ad0 Mon Sep 17 00:00:00 2001 From: Fu Diwei Date: Tue, 9 Apr 2024 09:48:16 +0800 Subject: [PATCH] =?UTF-8?q?feat(work):=20=E6=96=B0=E5=A2=9E=E8=8E=B7?= =?UTF-8?q?=E5=8F=96=E5=B7=B2=E6=9C=8D=E5=8A=A1=E7=9A=84=E5=A4=96=E9=83=A8?= =?UTF-8?q?=E8=81=94=E7=B3=BB=E4=BA=BA=E6=8E=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...tExecuteCgibinExternalContactExtensions.cs | 23 +++++ ...CgibinExternalContactContactListRequest.cs | 22 +++++ ...gibinExternalContactContactListResponse.cs | 86 +++++++++++++++++++ ...ibinExternalContactContactListRequest.json | 4 + ...binExternalContactContactListResponse.json | 36 ++++++++ 5 files changed, 171 insertions(+) create mode 100644 src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExternalContact/CgibinExternalContactContactListRequest.cs create mode 100644 src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExternalContact/CgibinExternalContactContactListResponse.cs create mode 100644 test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExternalContact/CgibinExternalContactContactListRequest.json create mode 100644 test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExternalContact/CgibinExternalContactContactListResponse.json diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinExternalContactExtensions.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinExternalContactExtensions.cs index 827b9cad..64da19a0 100644 --- a/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinExternalContactExtensions.cs +++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Extensions/WechatWorkClientExecuteCgibinExternalContactExtensions.cs @@ -345,6 +345,29 @@ namespace SKIT.FlurlHttpClient.Wechat.Work return await client.SendFlurlRequestAsJsonAsync(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false); } + /// + /// 异步调用 [POST] /cgi-bin/externalcontact/contact_list 接口。 + /// + /// REF:
+ /// + /// + /// + /// + /// + /// + /// + public static async Task ExecuteCgibinExternalContactContactListAsync(this WechatWorkClient client, Models.CgibinExternalContactContactListRequest 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 + .CreateFlurlRequest(request, HttpMethod.Post, "cgi-bin", "externalcontact", "contact_list") + .SetQueryParam("access_token", request.AccessToken); + + return await client.SendFlurlRequestAsJsonAsync(flurlReq, data: request, cancellationToken: cancellationToken).ConfigureAwait(false); + } + #region ContactWay /// /// 异步调用 [POST] /cgi-bin/externalcontact/add_contact_way 接口。 diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExternalContact/CgibinExternalContactContactListRequest.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExternalContact/CgibinExternalContactContactListRequest.cs new file mode 100644 index 00000000..1b82c64c --- /dev/null +++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExternalContact/CgibinExternalContactContactListRequest.cs @@ -0,0 +1,22 @@ +namespace SKIT.FlurlHttpClient.Wechat.Work.Models +{ + /// + /// 表示 [POST] /cgi-bin/externalcontact/contact_list 接口的请求。 + /// + public class CgibinExternalContactContactListRequest : WechatWorkRequest + { + /// + /// 获取或设置分页每页数量。 + /// + [Newtonsoft.Json.JsonProperty("limit")] + [System.Text.Json.Serialization.JsonPropertyName("limit")] + public int? Limit { get; set; } + + /// + /// 获取或设置分页游标。 + /// + [Newtonsoft.Json.JsonProperty("cursor")] + [System.Text.Json.Serialization.JsonPropertyName("cursor")] + public string? Cursor { get; set; } + } +} diff --git a/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExternalContact/CgibinExternalContactContactListResponse.cs b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExternalContact/CgibinExternalContactContactListResponse.cs new file mode 100644 index 00000000..db8717cc --- /dev/null +++ b/src/SKIT.FlurlHttpClient.Wechat.Work/Models/CgibinExternalContact/CgibinExternalContactContactListResponse.cs @@ -0,0 +1,86 @@ +namespace SKIT.FlurlHttpClient.Wechat.Work.Models +{ + /// + /// 表示 [POST] /cgi-bin/externalcontact/contact_list 接口的响应。 + /// + public class CgibinExternalContactContactListResponse : WechatWorkResponse + { + public static class Types + { + public class ExternalContact + { + /// + /// 获取或设置外部联系人 ID。 + /// + [Newtonsoft.Json.JsonProperty("external_userid")] + [System.Text.Json.Serialization.JsonPropertyName("external_userid")] + public string? ExternalUserId { get; set; } + + /// + /// 获取或设置外部联系人临时 ID。 + /// + [Newtonsoft.Json.JsonProperty("tmp_openid")] + [System.Text.Json.Serialization.JsonPropertyName("tmp_openid")] + public string? TempOpenId { get; set; } + + /// + /// 获取或设置外部联系人名称。 + /// + [Newtonsoft.Json.JsonProperty("name")] + [System.Text.Json.Serialization.JsonPropertyName("name")] + public string Name { get; set; } = default!; + + /// + /// 获取或设置添加此外部联系人的企业成员账号。 + /// + [Newtonsoft.Json.JsonProperty("follow_userid")] + [System.Text.Json.Serialization.JsonPropertyName("follow_userid")] + public string? FollowUserId { get; set; } + + /// + /// 获取或设置所在客户群的 ID。 + /// + [Newtonsoft.Json.JsonProperty("chat_id")] + [System.Text.Json.Serialization.JsonPropertyName("chat_id")] + public string? GroupChatId { get; set; } + + /// + /// 获取或设置所在客户群的群名。 + /// + [Newtonsoft.Json.JsonProperty("chat_name")] + [System.Text.Json.Serialization.JsonPropertyName("chat_name")] + public string? GroupChatName { get; set; } + + /// + /// 获取或设置添加时间戳。 + /// + [Newtonsoft.Json.JsonProperty("add_time")] + [System.Text.Json.Serialization.JsonPropertyName("add_time")] + public long AddTimestamp { get; set; } + + /// + /// 获取或设置是否标记为客户。 + /// + [Newtonsoft.Json.JsonProperty("is_customer")] + [Newtonsoft.Json.JsonConverter(typeof(Newtonsoft.Json.Converters.Common.NumericalBooleanConverter))] + [System.Text.Json.Serialization.JsonPropertyName("is_customer")] + [System.Text.Json.Serialization.JsonConverter(typeof(System.Text.Json.Serialization.Common.NumericalBooleanConverter))] + public bool IsCustomer { get; set; } + } + } + + /// + /// 获取或设置外部联系人列表。 + /// + [Newtonsoft.Json.JsonProperty("info_list")] + [System.Text.Json.Serialization.JsonPropertyName("info_list")] + public Types.ExternalContact[] ExternalContactList { get; set; } = default!; + + /// + /// 获取或设置分页游标。 + /// + [Newtonsoft.Json.JsonProperty("next_cursor")] + [System.Text.Json.Serialization.JsonPropertyName("next_cursor")] + public string? NextCursor { get; set; } + } +} diff --git a/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExternalContact/CgibinExternalContactContactListRequest.json b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExternalContact/CgibinExternalContactContactListRequest.json new file mode 100644 index 00000000..b23bffb2 --- /dev/null +++ b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExternalContact/CgibinExternalContactContactListRequest.json @@ -0,0 +1,4 @@ +{ + "cursor": "CURSOR", + "limit": 1000 +} diff --git a/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExternalContact/CgibinExternalContactContactListResponse.json b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExternalContact/CgibinExternalContactContactListResponse.json new file mode 100644 index 00000000..a0c45b3b --- /dev/null +++ b/test/SKIT.FlurlHttpClient.Wechat.Work.UnitTests/ModelSamples/CgibinExternalContact/CgibinExternalContactContactListResponse.json @@ -0,0 +1,36 @@ +{ + "errcode": 0, + "errmsg": "ok", + "info_list": [ + { + "is_customer": false, + "name": "***开", + "tmp_openid": "TMP_ID", + "follow_userid": "USER_ID", + "chat_name": "外联群1", + "add_time": 1694418699 + }, + { + "is_customer": true, + "tmp_openid": "TMP_ID", + "external_userid": "woAJ2GCAAAXtWyujaWJHDDGi0mACHAAA", + "follow_userid": "USER_ID", + "add_time": 1694418699 + }, + { + "is_customer": true, + "tmp_openid": "TMP_ID", + "external_userid": "woAJ2GCAAAXtWyujaWJHDDGi0mACHAAA", + "chat_id": "CHATID", + "add_time": 1694418699 + }, + { + "is_customer": false, + "tmp_openid": "TMP_ID", + "name": "***开", + "follow_userid": "USER_ID", + "add_time": 1694418699 + } + ], + "next_cursor": "NEXT_CURSOR" +}