Merge pull request #23 from NotFound403/1.3.0.rc

1.3.0

README.md

@@ -37,8 +37,6 @@
 
 1. 代码完全开源，使用前请认真尝试样例工程
 2. 在尝试步骤1的前提下遇到问题经过一系列努力无法解决，请提issue，或者通过自行扩展代码解决
-3. 不再提供任何无偿人工服务，不要把自己当上帝
-4. 会持续维护迭代
 
 ## 🏆简介
 
@@ -111,7 +109,7 @@ void webHooks()throws IOException{
 <dependency>
     <groupId>cn.felord</groupId>
     <artifactId>wecom-sdk</artifactId>
-    <version>1.2.9</version>
+    <version>1.3.0</version>
 </dependency>
 ```
 
@@ -122,7 +120,7 @@ void webHooks()throws IOException{
 <dependency>
     <groupId>cn.felord</groupId>
     <artifactId>rx-wecom-sdk</artifactId>
-    <version>1.2.9</version>
+    <version>1.3.0</version>
 </dependency>
 ```
 
@@ -134,7 +132,7 @@ void webHooks()throws IOException{
 <dependency>
     <groupId>cn.felord</groupId>
     <artifactId>wecom-sdk</artifactId>
-    <version>1.2.9</version>
+    <version>1.3.0</version>
     <exclusions>
         <exclusion>
             <groupId>com.squareup.okhttp3</groupId>

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>cn.felord</groupId>
     <artifactId>wecom</artifactId>
-    <version>1.2.9</version>
+    <version>1.3.0</version>
     <packaging>pom</packaging>
 
     <name>wecom</name>

rx-wecom-sdk/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>cn.felord</groupId>
         <artifactId>wecom</artifactId>
-        <version>1.2.9</version>
+        <version>1.3.0</version>
     </parent>
     <artifactId>rx-wecom-sdk</artifactId>
     <packaging>jar</packaging>

rx-wecom-sdk/src/main/java/cn/felord/reactive/api/CorpTagApi.java

@@ -39,7 +39,7 @@ public interface CorpTagApi {
      * @return the customer strategy detail response
      */
     @POST("externalcontact/get_corp_tag_list")
-    Single<GenericResponse<List<CorpTagGroup>>> corpTagList(@Body CorpTagIterator request);
+    Single<GenericResponse<List<CorpTagGroup>>> corpTagList(@Body CorpTagRequest request);
 
     /**
      * 添加企业客户标签
@@ -102,7 +102,7 @@ public interface CorpTagApi {
      * @return the generic response
      */
     @POST("externalcontact/del_strategy_tag")
-    Single<WeComResponse> delStrategyCorpTag(@Body CorpTagIterator request);
+    Single<WeComResponse> delStrategyCorpTag(@Body CorpTagRequest request);
 
     /**
      * 编辑客户企业标签

rx-wecom-sdk/src/main/java/cn/felord/reactive/api/CustomerAcquisitionApi.java

@@ -22,6 +22,8 @@
 import cn.felord.domain.externalcontact.AcquisitionLinkCreateRequest;
 import cn.felord.domain.externalcontact.AcquisitionLinkUpdateRequest;
 import cn.felord.domain.externalcontact.AcquisitionQuotaResponse;
+import cn.felord.domain.externalcontact.ChatInfoResponse;
+import cn.felord.domain.externalcontact.ChatKey;
 import cn.felord.domain.externalcontact.LinkCustomersResponse;
 import cn.felord.domain.externalcontact.LinkDetailResponse;
 import cn.felord.domain.externalcontact.LinkId;
@@ -40,7 +42,7 @@
  * 获客助手
  *
  * @author dax
- * @since 2024/5/30 21:28
+ * @since 2024 /5/30 21:28
  */
 public interface CustomerAcquisitionApi {
 
@@ -120,4 +122,16 @@ public interface CustomerAcquisitionApi {
     Single<LinkStatisticResponse> queryCustomerAcquisitionQuotas(@Query("link_id") String linkId,
                                                                  @Query("start_time") Instant startTime,
                                                                  @Query("end_time") Instant endTime);
+
+    /**
+     * 获取成员多次收消息详情
+     * <p>
+     * 企业和服务商可通过此接口获取成员多次收消息情况，如次数、客户id等信息。
+     *
+     * @param chatKey the chat key
+     * @return the chat info
+     * @since 1.2.9
+     */
+    @POST("externalcontact/customer_acquisition/get_chat_info")
+    Single<ChatInfoResponse> getChatInfo(@Body ChatKey chatKey);
 }

rx-wecom-sdk/src/main/java/cn/felord/reactive/api/InternalCorPayApi.java

@@ -47,7 +47,7 @@ public class InternalCorPayApi {
     InternalCorPayApi(String paySecret, String payAgentSecret, SSLManager sslManager, ConnectionPool connectionPool, HttpLoggingInterceptor.Level level) {
         this.paySecret = paySecret;
         this.payAgentSecret = payAgentSecret;
-        this.mmPayMktTransfersApi = WorkWechatRetrofitFactory.create(sslManager, connectionPool, level)
+        this.mmPayMktTransfersApi = WorkWechatRetrofitFactory.createPayRetrofit(sslManager, connectionPool, level)
                 .create(MmPayMktTransfersApi.class);
     }
 

rx-wecom-sdk/src/main/java/cn/felord/reactive/api/SmartSheetApi.java

@@ -0,0 +1,239 @@
+/*
+ * Copyright (c) 2024. felord.cn
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *       https://www.apache.org/licenses/LICENSE-2.0
+ * Website:
+ *       https://felord.cn
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package cn.felord.reactive.api;
+
+import cn.felord.domain.GenericResponse;
+import cn.felord.domain.WeComResponse;
+import cn.felord.domain.wedoc.smartsheet.AddOrUpdateFieldsRequest;
+import cn.felord.domain.wedoc.smartsheet.AddRecordRequest;
+import cn.felord.domain.wedoc.smartsheet.AddSheetRequest;
+import cn.felord.domain.wedoc.smartsheet.AddViewRequest;
+import cn.felord.domain.wedoc.smartsheet.DelFieldsRequest;
+import cn.felord.domain.wedoc.smartsheet.DelRecordRequest;
+import cn.felord.domain.wedoc.smartsheet.DelSheetRequest;
+import cn.felord.domain.wedoc.smartsheet.DelViewRequest;
+import cn.felord.domain.wedoc.smartsheet.QuerySheetRequest;
+import cn.felord.domain.wedoc.smartsheet.RecordResult;
+import cn.felord.domain.wedoc.smartsheet.SheetField;
+import cn.felord.domain.wedoc.smartsheet.SheetViewDetail;
+import cn.felord.domain.wedoc.smartsheet.SheetViewInfo;
+import cn.felord.domain.wedoc.smartsheet.SmartFieldsRequest;
+import cn.felord.domain.wedoc.smartsheet.SmartFieldsResponse;
+import cn.felord.domain.wedoc.smartsheet.SmartRecordsRequest;
+import cn.felord.domain.wedoc.smartsheet.SmartRecordsResponse;
+import cn.felord.domain.wedoc.smartsheet.SmartSheetInfo;
+import cn.felord.domain.wedoc.smartsheet.SmartSheetProperties;
+import cn.felord.domain.wedoc.smartsheet.SmartViewRequest;
+import cn.felord.domain.wedoc.smartsheet.SmartViewsResponse;
+import cn.felord.domain.wedoc.smartsheet.UpdateRecordRequest;
+import cn.felord.domain.wedoc.smartsheet.UpdateSheetRequest;
+import cn.felord.domain.wedoc.smartsheet.UpdateViewRequest;
+import io.reactivex.rxjava3.core.Single;
+import retrofit2.http.Body;
+import retrofit2.http.POST;
+
+import java.util.List;
+
+/**
+ * 智能表格操作相关API
+ *
+ * @author dax
+ * @since 2024 /8/30
+ */
+public interface SmartSheetApi {
+
+    /**
+     * 添加子表
+     * <p>
+     * 本接口用于在表格的某个位置添加一个智能表，
+     * 该智能表不存在视图、记录和字段，可以使用 API 在该智能表中添加视图、记录和字段。
+     *
+     * @param request the request
+     * @return the generic response
+     */
+    @POST("wedoc/smartsheet/add_sheet")
+    Single<GenericResponse<SmartSheetProperties>> addSheet(@Body AddSheetRequest request);
+
+    /**
+     * 删除子表
+     * <p>
+     * 本接口用于删除在线表格中的某个智能表。
+     *
+     * @param request the request
+     * @return the we com response
+     */
+    @POST("wedoc/smartsheet/delete_sheet")
+    Single<WeComResponse> deleteSheet(@Body DelSheetRequest request);
+
+    /**
+     * 更新子表
+     * <p>
+     * 本接口用于修改表格中某个子表的标题。
+     *
+     * @param request the request
+     * @return the we com response
+     */
+    @POST("wedoc/smartsheet/update_sheet")
+    Single<WeComResponse> updateSheet(@Body UpdateSheetRequest request);
+
+    /**
+     * 添加视图
+     * <p>
+     * 本接口用于在 Smartsheet 中的某个子表里添加一个新视图。单表最多允许有200个视图。
+     *
+     * @param request the request
+     * @return generic response
+     */
+    @POST("wedoc/smartsheet/add_view")
+    Single<GenericResponse<SheetViewInfo>> addView(@Body AddViewRequest request);
+
+    /**
+     * 删除视图
+     * <p>
+     * 本接口用于在 smartsheet 中的某个子表里删除若干个视图。
+     *
+     * @param request the request
+     * @return the we com response
+     */
+    @POST("wedoc/smartsheet/delete_views")
+    Single<WeComResponse> deleteViews(@Body DelViewRequest request);
+
+    /**
+     * 更新视图
+     * <p>
+     * 本接口用于在 Smartsheet 中的某个子表里添加一个新视图。
+     *
+     * @param request the request
+     * @return the generic response
+     */
+    @POST("wedoc/smartsheet/update_view")
+    Single<GenericResponse<SheetViewDetail>> updateView(@Body UpdateViewRequest request);
+
+    /**
+     * 添加字段
+     * <p>
+     * 本接口用于在智能表中的某个子表里添加一列或多列新字段。单表最多允许有150个字段。
+     *
+     * @param request the request
+     * @return the generic response
+     */
+    @POST("wedoc/smartsheet/add_fields")
+    Single<GenericResponse<List<SheetField>>> addFields(@Body AddOrUpdateFieldsRequest request);
+
+    /**
+     * 删除字段
+     * <p>
+     * 本接口用于删除智能表中的某个子表里的一列或多列字段。
+     *
+     * @param request the request
+     * @return the we com response
+     */
+    @POST("wedoc/smartsheet/delete_fields")
+    Single<WeComResponse> deleteFields(@Body DelFieldsRequest request);
+
+    /**
+     * 更新字段
+     * <p>
+     * 本接口用于更新智能中的某个子表里的一个或多个字段的标题和字段属性信息。
+     * 该接口只能更新字段名、字段属性，不能更新字段类型。
+     *
+     * @param request the request
+     * @return the generic response
+     */
+    @POST("wedoc/smartsheet/update_fields")
+    Single<GenericResponse<List<SheetField>>> updateFields(@Body AddOrUpdateFieldsRequest request);
+
+    /**
+     * 添加记录
+     * <p>
+     * 本接口用于在 Smartsheet 中的某个子表里添加一行或多行新记录。单表最多允许有40000行记录。
+     * 不能通过添加记录接口给创建时间、最后编辑时间、创建人和最后编辑人四种类型的字段添加记录。
+     *
+     * @param request the request
+     * @return the generic response
+     */
+    @POST("wedoc/smartsheet/add_records")
+    Single<GenericResponse<List<RecordResult>>> addRecords(@Body AddRecordRequest request);
+
+    /**
+     * 删除记录
+     * <p>
+     * 本接口用于删除 Smartsheet 的某个子表中的一行或多行记录。
+     *
+     * @param request the request
+     * @return the we com response
+     */
+    @POST("wedoc/smartsheet/delete_records")
+    Single<WeComResponse> deleteRecords(@Body DelRecordRequest request);
+
+    /**
+     * 更新记录
+     * <p>
+     * 本接口用于更新 Smartsheet 中的某个子表里的一行或多行记录。
+     * 注意：不能通过更新记录接口给创建时间、最后编辑时间、创建人和最后编辑人四种类型的字段更新记录。
+     *
+     * @param request the request
+     * @return the we com response
+     */
+    @POST("wedoc/smartsheet/update_records")
+    Single<GenericResponse<List<RecordResult>>> updateRecords(@Body UpdateRecordRequest request);
+
+    /**
+     * 查询子表
+     * <p>
+     * 本接口用于查询一篇在线表格中全部智能表信息。
+     *
+     * @param request the request
+     * @return the sheet
+     */
+    @POST("wedoc/smartsheet/get_sheet")
+    Single<GenericResponse<List<SmartSheetInfo>>> getSheet(@Body QuerySheetRequest request);
+
+    /**
+     * 查询视图
+     * <p>
+     * 本接口用于获取 Smartsheet 中某个子表里全部视图信息。
+     *
+     * @param request the request
+     * @return the views
+     */
+    @POST("wedoc/smartsheet/get_views")
+    Single<SmartViewsResponse> getViews(@Body SmartViewRequest request);
+
+    /**
+     * 查询字段
+     * <p>
+     * 本接口用于获取智能表中某个子表下字段信息，
+     * 该接口可以完成下面三种功能：获取全部字段信息、依据字段名获取对应字段、依据字段 ID 获取对应字段信息。
+     *
+     * @param request the request
+     * @return the fields
+     */
+    @POST("wedoc/smartsheet/get_fields")
+    Single<SmartFieldsResponse> getFields(@Body SmartFieldsRequest request);
+
+    /**
+     * 查询记录
+     * <p>
+     * 本接口用于获取 Smartsheet 中某个子表下记录信息，
+     * 该接口可以完成下面三种功能：获取全部记录信息、依据字段名和记录 ID 获取对应记录、对记录进行排序。
+     *
+     * @param request the request
+     * @return the records
+     */
+    @POST("wedoc/smartsheet/get_records")
+    Single<SmartRecordsResponse> getRecords(@Body SmartRecordsRequest request);
+}

rx-wecom-sdk/src/main/java/cn/felord/reactive/api/WedocApi.java

@@ -51,4 +51,13 @@ public FormApi formApi() {
         return workWeChatApiClient.retrofit().create(FormApi.class);
     }
 
+    /**
+     * 智能表格
+     *
+     * @return the smart sheet api
+     */
+    public SmartSheetApi smartSheetApi() {
+        return workWeChatApiClient.retrofit().create(SmartSheetApi.class);
+    }
+
 }

samples/spring-boot-sample/pom.xml

@@ -39,7 +39,7 @@
         <dependency>
             <groupId>cn.felord</groupId>
             <artifactId>wecom-sdk</artifactId>
-            <version>1.2.9</version>
+            <version>1.3.0</version>
         </dependency>
         <dependency>
             <groupId>net.sf.ehcache</groupId>