jpsclient 1.3.0 → 1.4.0

data/lib/jpsclient/api/image_search.rb

@@ -0,0 +1,74 @@
+module JPSClient
+  module API
+    # ImageSearch 相关 API
+    # 处理图片搜索相关接口
+    module ImageSearch
+
+      # 通过文本搜索相似图片
+      #
+      # @param query [String] 搜索关键词（必需）
+      # @param limit [Integer] 返回结果数量（可选，默认10）
+      # @param offset [Integer] 偏移量，用于分页（可选）
+      # @return [Hash] API响应
+      def search_image_by_text(query:, limit: 10, offset: 0)
+        config = @request_config && @request_config["image_search_by_text"]
+        raise JPSClient::ExceptionError, "Missing config for image_search_by_text" unless config && config["url"]
+
+        path = config["url"]
+        params = {
+          query: query,
+          limit: limit,
+          offset: offset
+        }
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 通过图片搜索相似图片（以图搜图）
+      #
+      # @param image_url [String] 图片URL（与image_data二选一）
+      # @param image_data [String] Base64编码的图片数据（与image_url二选一）
+      # @param limit [Integer] 返回结果数量（可选，默认10）
+      # @param threshold [Float] 相似度阈值，0-1之间（可选，默认0.7）
+      # @return [Hash] API响应
+      def search_image_by_image(image_url: nil, image_data: nil, limit: 10, threshold: 0.7)
+        config = @request_config && @request_config["image_search_by_image"]
+        raise JPSClient::ExceptionError, "Missing config for image_search_by_image" unless config && config["url"]
+
+        # 验证参数
+        unless image_url || image_data
+          raise JPSClient::ExceptionError, "Either image_url or image_data must be provided"
+        end
+
+        path = config["url"]
+        params = {
+          limit: limit,
+          threshold: threshold
+        }
+        params[:image_url] = image_url if image_url
+        params[:image_data] = image_data if image_data
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+    end
+  end
+end

data/lib/jpsclient/api/lark_card_message.rb

@@ -0,0 +1,45 @@
+module JPSClient
+  module API
+    # LarkCardMessage 相关 API
+    # 处理飞书卡片消息相关接口
+    module LarkCardMessage
+
+      # 获取飞书卡片消息发送历史记录
+      #
+      # @param page [Integer] 页码（可选，默认1）
+      # @param page_size [Integer] 每页数量（可选，默认20）
+      # @param chat_id [String] 群组ID（可选）
+      # @param user_id [String] 用户ID（可选）
+      # @param start_time [String] 开始时间（可选）
+      # @param end_time [String] 结束时间（可选）
+      # @return [Hash] API响应
+      def get_lark_card_message_history(page: 1, page_size: 20, chat_id: nil, user_id: nil, start_time: nil, end_time: nil)
+        config = @request_config && @request_config["lark_card_message_history_list"]
+        raise JPSClient::ExceptionError, "Missing config for lark_card_message_history_list" unless config && config["url"]
+
+        path = config["url"]
+
+        params = {
+          page: page,
+          pageSize: page_size
+        }
+        params[:chatId] = chat_id if chat_id
+        params[:userId] = user_id if user_id
+        params[:startTime] = start_time if start_time
+        params[:endTime] = end_time if end_time
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+    end
+  end
+end

data/lib/jpsclient/api/lark_department.rb

@@ -0,0 +1,44 @@
+module JPSClient
+  module API
+    # LarkDepartment 相关 API
+    # 处理飞书部门管理相关接口
+    module LarkDepartment
+
+      # 获取飞书部门列表
+      #
+      # @param parent_department_id [String] 父部门ID（可选，不填则获取所有部门）
+      # @param fetch_child [Boolean] 是否递归获取子部门（可选，默认true）
+      # @param page_size [Integer] 分页大小（可选，默认50，最大50）
+      # @param page_token [String] 分页标记（可选）
+      # @return [Hash] API响应
+      def get_lark_department_list(parent_department_id: nil, fetch_child: true, page_size: 50, page_token: nil)
+        config = @request_config && @request_config["lark_department_all"]
+        raise JPSClient::ExceptionError, "Missing config for lark_department_all" unless config && config["url"]
+
+        path = config["url"]
+
+        params = {
+          fetch_child: fetch_child,
+          page_size: page_size
+        }
+        params[:parent_department_id] = parent_department_id if parent_department_id
+        params[:page_token] = page_token if page_token
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 获取所有部门（别名方法）
+      alias get_all_lark_departments get_lark_department_list
+
+    end
+  end
+end

data/lib/jpsclient/api/lark_file.rb

@@ -0,0 +1,32 @@
+module JPSClient
+  module API
+    # LarkFile 相关 API
+    # 处理飞书文件和图片相关接口
+    module LarkFile
+
+      # 通过图片 key 获取下载链接
+      #
+      # @param image_key [String] 图片的唯一标识 key（必需）
+      # @return [Hash] API响应
+      def get_lark_file_url_by_image_key(image_key:)
+        config = @request_config && @request_config["lark_file_url_by_image_key"]
+        raise JPSClient::ExceptionError, "Missing config for lark_file_url_by_image_key" unless config && config["url"]
+
+        path = config["url"]
+        params = { image_key: image_key }
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+    end
+  end
+end

data/lib/jpsclient/api/lark_leave_approval.rb

@@ -0,0 +1,47 @@
+module JPSClient
+  module API
+    # LarkLeaveApproval 相关 API
+    # 处理飞书请假审批相关接口
+    module LarkLeaveApproval
+
+      # 获取请假审批日历
+      #
+      # @param start_time [String] 开始时间，格式：YYYY-MM-DD（可选）
+      # @param end_time [String] 结束时间，格式：YYYY-MM-DD（可选）
+      # @param user_ids [Array<String>, String] 用户ID列表（可选，支持数组或逗号分隔的字符串）
+      # @param department_id [String] 部门ID（可选）
+      # @param status [String] 审批状态（可选）
+      # @return [Hash] API响应
+      def get_lark_leave_approval_calendar(start_time: nil, end_time: nil, user_ids: nil, department_id: nil, status: nil)
+        config = @request_config && @request_config["lark_leave_approval_calendar"]
+        raise JPSClient::ExceptionError, "Missing config for lark_leave_approval_calendar" unless config && config["url"]
+
+        path = config["url"]
+
+        params = {}
+        params[:start_time] = start_time if start_time
+        params[:end_time] = end_time if end_time
+
+        # 处理 user_ids，支持数组或字符串
+        if user_ids
+          params[:user_ids] = user_ids.is_a?(Array) ? user_ids.join(',') : user_ids
+        end
+
+        params[:department_id] = department_id if department_id
+        params[:status] = status if status
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+    end
+  end
+end

data/lib/jpsclient/api/lark_message.rb

@@ -0,0 +1,32 @@
+module JPSClient
+  module API
+    # LarkMessage 相关 API
+    # 处理飞书消息相关接口
+    module LarkMessage
+
+      # 获取飞书消息详情
+      #
+      # @param message_id [String] 消息ID（必需）
+      # @return [Hash] API响应
+      def get_lark_message_detail(message_id:)
+        config = @request_config && @request_config["lark_message_detail"]
+        raise JPSClient::ExceptionError, "Missing config for lark_message_detail" unless config && config["url"]
+
+        path = config["url"]
+        params = { message_id: message_id }
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+    end
+  end
+end

data/lib/jpsclient/api/nuget.rb

@@ -0,0 +1,30 @@
+module JPSClient
+  module API
+    # NuGet 相关 API
+    # 处理 NuGet 包管理服务相关接口
+    module NuGet
+
+      # 获取 NuGet v3 服务索引
+      #
+      # @return [Hash] NuGet 服务索引信息
+      def get_nuget_service_index
+        config = @request_config && @request_config["nuget_service_index"]
+        raise JPSClient::ExceptionError, "Missing config for nuget_service_index" unless config && config["url"]
+
+        path = config["url"]
+
+        response = @http_client.get(path)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+    end
+  end
+end

data/lib/jpsclient/api/permission.rb

@@ -0,0 +1,137 @@
+module JPSClient
+  module API
+    # Permission 相关 API
+    # 处理权限管理相关接口
+    module Permission
+
+      # 获取权限列表
+      #
+      # @param params [Hash] 请求参数（可选）
+      # @return [Hash] API响应
+      def get_permission_list(params: {})
+        config = @request_config && @request_config["permission_list"]
+        raise JPSClient::ExceptionError, "Missing config for permission_list" unless config && config["url"]
+
+        path = config["url"]
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 获取权限详情
+      #
+      # @param id [String, Integer] 权限ID（必需）
+      # @return [Hash] API响应
+      def get_permission_detail(id:)
+        config = @request_config && @request_config["permission_detail"]
+        raise JPSClient::ExceptionError, "Missing config for permission_detail" unless config && config["url"]
+
+        path = config["url"]
+        params = { id: id }
+
+        response = @http_client.get(path, params: params)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.get(path, params: params)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 创建权限
+      #
+      # @param name [String] 权限名称（必需）
+      # @param code [String] 权限代码（必需）
+      # @param description [String] 权限描述（可选）
+      # @return [Hash] API响应
+      def create_permission(name:, code:, description: nil)
+        config = @request_config && @request_config["permission_create"]
+        raise JPSClient::ExceptionError, "Missing config for permission_create" unless config && config["url"]
+
+        path = config["url"]
+
+        body = {
+          name: name,
+          code: code
+        }
+        body[:description] = description if description
+
+        response = @http_client.post(path, body: body)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: body)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 更新权限
+      #
+      # @param id [String, Integer] 权限ID（必需）
+      # @param name [String] 权限名称（可选）
+      # @param code [String] 权限代码（可选）
+      # @param description [String] 权限描述（可选）
+      # @return [Hash] API响应
+      def update_permission(id:, name: nil, code: nil, description: nil)
+        config = @request_config && @request_config["permission_update"]
+        raise JPSClient::ExceptionError, "Missing config for permission_update" unless config && config["url"]
+
+        path = config["url"]
+
+        body = { id: id }
+        body[:name] = name if name
+        body[:code] = code if code
+        body[:description] = description if description
+
+        response = @http_client.post(path, body: body)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: body)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+      # 删除权限
+      #
+      # @param id [String, Integer] 权限ID（必需）
+      # @return [Hash] API响应
+      def delete_permission(id:)
+        config = @request_config && @request_config["permission_delete"]
+        raise JPSClient::ExceptionError, "Missing config for permission_delete" unless config && config["url"]
+
+        path = config["url"]
+        body = { id: id }
+
+        response = @http_client.post(path, body: body)
+        result = JPSClient::Response.new(response)
+
+        if result.need_login?
+          do_login(force_login: true)
+          response = @http_client.post(path, body: body)
+          result = JPSClient::Response.new(response)
+        end
+
+        return result.to_h
+      end
+
+    end
+  end
+end