k3cloud_webapi_sdk 8.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: a27712a9e76c2eda70bb656656b3954970d77675f3de42da92051b45a740f89e
+  data.tar.gz: 43933aac6f718c17beecb34fbb5a283125a73127bdcc2657dd62e70f710022f5
+SHA512:
+  metadata.gz: 8c8e8b13851a2db1e4d358c27e8283c388443ec8e6b9b72cf646a0532af7cc7e1a074e30a157abce3bfc429a09451d480fb2b01c3ca8cd1f19ab9b09094092bf
+  data.tar.gz: bf4ec0fd3ef417210f99f8d5bab096204434a52c35ebc78e7fa54022cf5c6a5cc2a0867b110fd63997e73628a9e7c739055bb9331d8edfd634a39b834e62dd11

data/lib/k3cloud_webapi_sdk/const/const_define.rb

@@ -0,0 +1,25 @@
+module K3CloudWebapiSdk
+  module Const
+    # InvokeMethod constants
+    module InvokeMethod
+      SYNC = 1
+      ASYNC = 2
+      QUERY = 3
+    end
+    
+    # QueryState constants
+    module QueryState
+      Pending = 0
+      Running = 1
+      Complete = 2
+    end
+    
+    # QueryMode constants
+    module QueryMode
+      BeginMethod_Header = 'beginmethod'
+      BeginMethod_Method = 'BeginQueryImpl'
+      QueryMethod_Header = 'querymethod'
+      QueryMethod_Method = 'QueryAsyncResult'
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/const/header_param.rb

@@ -0,0 +1,17 @@
+module K3CloudWebapiSdk
+  module Const
+    module HeaderParam
+      X_Api_ClientID = 'X-Api-ClientID'
+      X_Api_Auth_Version = 'X-Api-Auth-Version'
+      X_Api_Timestamp = 'x-api-timestamp'
+      X_Api_Nonce = 'x-api-nonce'
+      X_Api_SignHeaders = 'x-api-signheaders'
+      X_Api_Signature = 'X-Api-Signature'
+      X_KD_AppKey = 'X-Kd-Appkey'
+      X_KD_AppData = 'X-Kd-Appdata'
+      X_KD_Signature = 'X-Kd-Signature'
+      KDService_SessionId = 'kdservice-sessionid'
+      Cookie_Set = 'Set-Cookie'
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/core/webapi_client.rb

@@ -0,0 +1,255 @@
+require 'json'
+require 'rest-client'
+require 'uri'
+require 'time'
+require_relative '../const/const_define'
+require_relative '../const/header_param'
+require_relative '../model/cookie'
+require_relative '../model/cookie_store'
+require_relative '../model/identity'
+require_relative '../model/query_param'
+require_relative '../util/encode_util'
+require_relative '../util/hmac_util'
+require_relative '../util/base64_util'
+
+module K3CloudWebapiSdk
+  module Core
+    # Result validation function
+    def self.valid_result(response_content)
+      if response_content.start_with?('response_error:')
+        res_error = response_content.sub('response_error:', '').strip
+        if !res_error.empty?
+          raise RuntimeError, res_error
+        else
+          raise RuntimeError, 'Empty exception message'
+        end
+      else
+        response_content
+      end
+    end
+    
+    # Web API Client class
+    class WebApiClient
+      attr_accessor :initialize, :config, :identify, :cookies_store, :connect_timeout, :request_timeout, :proxy
+      
+      def initialize
+        @initialize = false
+        @config = nil
+        @identify = nil
+        @cookies_store = Model::CookieStore.new
+        @connect_timeout = 120
+        @request_timeout = 120
+        @proxy = ''
+      end
+      
+      # Initialize the client
+      def init(server_url, timeout, sdk_initialize)
+        @initialize = sdk_initialize
+        
+        if @config.nil?
+          raise 'Configuration file unload, you need initial config firstly!'
+        end
+        
+        if server_url.empty?
+          # Cancel default old gateway, require url input by Ann 2025-01-15
+          raise 'ServerUrl is required'
+        end
+        
+        @identify = Model::Identity.new(
+          server_url, 
+          @config.dcid, 
+          @config.user_name, 
+          @config.app_id, 
+          @config.app_secret, 
+          @config.org_num, 
+          @config.lcid, 
+          ''
+        )
+        
+        @connect_timeout = @config.connect_timeout if @config.connect_timeout > 0
+        @request_timeout = @config.request_timeout if @config.request_timeout > 0
+        @request_timeout = timeout if timeout > 0
+        @proxy = @config.proxy if !@config.proxy.empty?
+        
+        self
+      end
+      
+      # Build request headers
+      def build_header(service_url)
+        path_url = service_url
+        if service_url.start_with?('http')
+          uri = URI.parse(service_url)
+          path_url = uri.path
+        end
+        
+        path_url = ERB::Util.url_encode(path_url).gsub('/', '%2F')
+        time_stamp = Time.now.to_i.to_s
+        nonce = Time.now.to_i.to_s
+        client_id = ''
+        client_sec = ''
+        
+        arr = @identify.app_id.split('_')
+        if arr.length == 2
+          client_id = arr[0]
+          client_sec = Util::EncodeUtil.decode_app_secret(arr[1])
+        end
+        
+        api_sign = 'POST\n' + path_url + '\n\nx-api-nonce:' + nonce + '\nx-api-timestamp:' + time_stamp + '\n'
+        app_data = @identify.dcid + ',' + @identify.user_name + ',' + @identify.lcid.to_s + ',' + @identify.org_num.to_s
+        
+        dic_header = {
+          Const::HeaderParam::X_Api_ClientID => client_id,
+          Const::HeaderParam::X_Api_Auth_Version => '2.0',
+          Const::HeaderParam::X_Api_Timestamp => time_stamp,
+          Const::HeaderParam::X_Api_Nonce => nonce,
+          Const::HeaderParam::X_Api_SignHeaders => 'x-api-timestamp,x-api-nonce',
+          Const::HeaderParam::X_Api_Signature => Util::HmacUtil.hmac_sha256(api_sign, client_sec),
+          Const::HeaderParam::X_KD_AppKey => @identify.app_id,
+          Const::HeaderParam::X_KD_AppData => Util::Base64Util.encode(app_data.bytes),
+          Const::HeaderParam::X_KD_Signature => Util::HmacUtil.hmac_sha256(@identify.app_id + app_data, @identify.app_secret)
+        }
+        
+        if !@cookies_store.sid.empty?
+          dic_header[Const::HeaderParam::KDService_SessionId] = @cookies_store.sid
+        end
+        
+        if @cookies_store.cookies.length > 0
+          cookie_str = 'Theme=standard'
+          @cookies_store.cookies.each_value do |cookie|
+            cookie_str += ';' + cookie.to_s
+          end
+          dic_header['Cookie'] = cookie_str
+        end
+        
+        dic_header['Accept-Charset'] = 'utf-8'
+        dic_header['User-Agent'] = 'Kingdee/Ruby WebApi SDK 8.2.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)'
+        dic_header['Content-Type'] = 'application/json'
+        
+        dic_header
+      end
+      
+      # Post JSON data
+      def post_json(service_name, json_data = {}, invoke_type = Const::InvokeMethod::SYNC)
+        json_data ||= {}
+        
+        req_url = if @identify.server_url.end_with?('/')
+                    @identify.server_url + service_name + '.common.kdsvc'
+                  else
+                    @identify.server_url + '/' + service_name + '.common.kdsvc'
+                  end
+        
+        proxies = nil
+        if !@proxy.empty?
+          proxies = { URI.parse(@proxy).scheme => @proxy }
+        end
+        
+        if invoke_type == Const::InvokeMethod::QUERY
+          json_data[Const::QueryMode::BeginMethod_Header] = Const::QueryMode::BeginMethod_Method
+          json_data[Const::QueryMode::QueryMethod_Header] = Const::QueryMode::QueryMethod_Method
+        end
+        
+        headers = build_header(req_url)
+        
+        begin
+          response = RestClient.post(
+            req_url,
+            json_data.to_json,
+            headers: headers,
+            timeout: [@connect_timeout, @request_timeout],
+            verify_ssl: false,
+            proxy: @proxy.empty? ? nil : @proxy
+          )
+          
+          if response.code == 200 || response.code == 206
+            fill_cookie_and_header(response.cookies, response.headers)
+            return Core.valid_result(response.body)
+          else
+            raise "HTTP Error #{response.code}: #{response.body}"
+          end
+        rescue RestClient::Exception => e
+          raise "Request failed: #{e.message}"
+        end
+      end
+      
+      # Fill cookies and headers
+      def fill_cookie_and_header(cookies, headers)
+        @cookies_store.set_sid(cookies[Const::HeaderParam::KDService_SessionId])
+        
+        if headers[Const::HeaderParam::Cookie_Set]
+          @cookies_store.cookies.clear
+          headers[Const::HeaderParam::Cookie_Set].split(',').each do |item|
+            ck = Model::Cookie.parse(item)
+            if ck
+              @cookies_store.cookies[ck.name] = ck
+            end
+          end
+        end
+      end
+      
+      # Execute API call
+      def execute(service_name, json_data = nil, invoke_type = Const::InvokeMethod::SYNC)
+        if !@initialize
+          raise '拒绝请求，请先正确初始化!'
+        end
+        
+        if @config.nil?
+          raise '请先初始化SDK配置信息!'
+        end
+        
+        case invoke_type
+        when Const::InvokeMethod::SYNC
+          post_json(service_name, json_data, Const::InvokeMethod::SYNC)
+        when Const::InvokeMethod::QUERY
+          execute_by_query(service_name, json_data)
+        else
+          raise 'Not support for InvokeMode:' + invoke_type.to_s
+        end
+      end
+      
+      # Execute by query method
+      def execute_by_query(service_name, json_data = nil)
+        response_content = post_json(service_name, json_data, Const::InvokeMethod::QUERY)
+        json_result = JSON.parse(response_content)
+        
+        if json_result['Status'] == Const::QueryState::Complete
+          return json_result['Result'].to_json
+        else
+          return query_task_result(
+            service_name, 
+            { 'TaskId' => json_result['TaskId'], 'Cancelled' => false }, 
+            5
+          )
+        end
+      end
+      
+      # Query task result
+      def query_task_result(service_name, param, retry_count)
+        sleep(1)
+        
+        dot_index = service_name.rindex('.')
+        query_service = if dot_index
+                         service_name[0, dot_index] + '.' + Const::QueryMode::QueryMethod_Method
+                       else
+                         service_name + '.' + Const::QueryMode::QueryMethod_Method
+                       end
+        
+        begin
+          response_content = post_json(query_service, { 'queryInfo' => param.to_json }, Const::InvokeMethod::SYNC)
+          json_result = JSON.parse(response_content)
+          
+          if json_result['Status'] == Const::QueryState::Complete
+            json_result['Result'].to_json
+          else
+            query_task_result(service_name, param, 5)
+          end
+        rescue => err
+          if retry_count > 0
+            query_task_result(service_name, param, retry_count - 1)
+          else
+            raise err
+          end
+        end
+      end
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/main.rb

@@ -0,0 +1,213 @@
+require_relative 'core/webapi_client'
+require_relative 'const/const_define'
+require_relative 'util/config_util'
+
+module K3CloudWebapiSdk
+  # Main K3Cloud API SDK class
+  class K3CloudApiSdk < Core::WebApiClient
+    attr_accessor :server_url, :timeout
+    
+    def initialize(server_url, timeout = 120)
+      super()
+      @server_url = server_url
+      @timeout = timeout
+    end
+    
+    # Initialize configuration with parameters
+    def init_config(acct_id, user_name, app_id, app_secret, server_url, lcid = 2052, org_num = 0,
+                   connect_timeout = 120, request_timeout = 120, proxy = '')
+      
+      @config = Util::ConfigUtil.init_config_by_params(
+        acct_id, user_name, app_id, app_secret, server_url, lcid, org_num,
+        connect_timeout, request_timeout, proxy
+      )
+      
+      init(@server_url, @timeout, is_valid)
+    end
+    
+    # Initialize configuration from file
+    def init(config_path = 'conf.ini', config_node = 'config')
+      @config = Util::ConfigUtil.init_config(config_path, config_node)
+      init(@server_url, @timeout, is_valid)
+    end
+    
+    # Check if configuration is valid
+    def is_valid
+      messages = []
+      
+      messages << '账套ID' if @config.dcid.empty?
+      messages << '用户' if @config.user_name.empty?
+      messages << '应用ID' if @config.app_id.empty?
+      messages << '应用密钥' if @config.app_secret.empty?
+      
+      if !messages.empty?
+        puts 'SDK初始化失败，缺少必填授权项：' + messages.join(',')
+        return false
+      else
+        return true
+      end
+    end
+    
+    # Get data centers
+    def get_data_centers
+      execute('Kingdee.BOS.ServiceFacade.ServicesStub.Account.AccountService.GetDataCenterList')
+    end
+    
+    # Execute operation
+    def execute_operation(formid, op_number, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.ExcuteOperation',
+              { 'formid' => formid, 'opNumber' => op_number, 'data' => data })
+    end
+    
+    # Save data
+    def save(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Save',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Batch save
+    def batch_save(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.BatchSave',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Batch save with query
+    def batch_save_query(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.BatchSave',
+              { 'formid' => formid, 'data' => data },
+              Const::InvokeMethod::QUERY)
+    end
+    
+    # Audit
+    def audit(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Audit',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Delete
+    def delete(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Delete',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Undo audit
+    def un_audit(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.UnAudit',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Submit
+    def submit(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Submit',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # View
+    def view(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.View',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Execute bill query
+    def execute_bill_query(data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.ExecuteBillQuery',
+              { 'data' => data })
+    end
+    
+    # Bill query
+    def bill_query(data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.BillQuery',
+              { 'data' => data })
+    end
+    
+    # Draft
+    def draft(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Draft',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Allocate
+    def allocate(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Allocate',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Flex save
+    def flex_save(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.FlexSave',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Send message
+    def send_msg(data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.SendMsg',
+              { 'data' => data })
+    end
+    
+    # Push
+    def push(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Push',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Group save
+    def group_save(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.GroupSave',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Disassembly
+    def disassembly(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.Disassembly',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Query business info
+    def query_business_info(data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.QueryBusinessInfo',
+              { 'data' => data })
+    end
+    
+    # Query group info
+    def query_group_info(data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.QueryGroupInfo',
+              { 'data' => data })
+    end
+    
+    # Workflow audit
+    def workflow_audit(data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.WorkflowAudit',
+              { 'data' => data })
+    end
+    
+    # Group delete
+    def group_delete(data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.GroupDelete',
+              { 'data' => data })
+    end
+    
+    # Switch organization
+    def switch_org(data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.SwitchOrg',
+              { 'data' => data })
+    end
+    
+    # Get system report data
+    def get_sys_report_data(formid, data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.GetSysReportData',
+              { 'formid' => formid, 'data' => data })
+    end
+    
+    # Upload attachment
+    def attachment_upload(data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.AttachmentUpload',
+              { 'data' => data })
+    end
+    
+    # Download attachment
+    def attachment_download(data)
+      execute('Kingdee.BOS.WebApi.ServicesStub.DynamicFormService.AttachmentDownLoad',
+              { 'data' => data })
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/model/api_config.rb

@@ -0,0 +1,33 @@
+module K3CloudWebapiSdk
+  module Model
+    class ApiConfig
+      # Class variable for XOR code (equivalent to Python's class variable)
+      @@xor_code = ''
+      
+      attr_accessor :server_url, :dcid, :user_name, :app_id, :app_secret,
+                    :lcid, :org_num, :connect_timeout, :request_timeout, :proxy
+      
+      def initialize
+        # Cancel default old gateway, require url input by Ann 2025-01-15
+        @server_url = ''
+        @dcid = ''
+        @user_name = ''
+        @app_id = ''
+        @app_secret = ''
+        @lcid = 2052
+        @org_num = 0
+        @connect_timeout = 120
+        @request_timeout = 120
+        @proxy = ''
+      end
+      
+      def self.xor_code
+        @@xor_code
+      end
+      
+      def self.xor_code=(value)
+        @@xor_code = value
+      end
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/model/cookie.rb

@@ -0,0 +1,33 @@
+module K3CloudWebapiSdk
+  module Model
+    class Cookie
+      attr_accessor :name, :value, :domain, :path, :expires, :http_only, :secure
+      
+      def initialize(name: '', value: '', domain: '', path: '/', expires: nil, http_only: false, secure: false)
+        @name = name
+        @value = value
+        @domain = domain
+        @path = path
+        @expires = expires
+        @http_only = http_only
+        @secure = secure
+      end
+      
+      def to_s
+        "#{@name}=#{@value}"
+      end
+      
+      def to_h
+        {
+          name: @name,
+          value: @value,
+          domain: @domain,
+          path: @path,
+          expires: @expires,
+          http_only: @http_only,
+          secure: @secure
+        }
+      end
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/model/cookie_store.rb

@@ -0,0 +1,37 @@
+module K3cloudWebapiSdk
+  module Model
+    class CookieStore
+      attr_accessor :sid, :cookies
+      
+      def initialize(sid = '', cookies = nil)
+        @sid = sid
+        @cookies = cookies || {}
+      end
+      
+      def set_sid(sid)
+        @sid = sid if !sid.nil? && !sid.empty?
+      end
+      
+      def set_cookie(name, value, domain = '', path = '/', expires = nil)
+        @cookies[name] = {
+          value: value,
+          domain: domain,
+          path: path,
+          expires: expires
+        }
+      end
+      
+      def get_cookie(name)
+        @cookies[name]
+      end
+      
+      def delete_cookie(name)
+        @cookies.delete(name)
+      end
+      
+      def clear_cookies
+        @cookies.clear
+      end
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/model/identity.rb

@@ -0,0 +1,31 @@
+module K3CloudWebapiSdk
+  module Model
+    class Identity
+      attr_accessor :server_url, :dcid, :lcid, :user_name, :pwd, :app_id, :app_secret, :org_num
+      
+      def initialize(server_url, dcid, user_name, app_id, app_secret, org_num, lcid = 2052, pwd = '')
+        @server_url = server_url
+        @dcid = dcid
+        @lcid = lcid
+        @user_name = user_name
+        @pwd = pwd
+        @app_id = app_id
+        @app_secret = app_secret
+        @org_num = org_num
+      end
+      
+      def to_h
+        {
+          server_url: @server_url,
+          dcid: @dcid,
+          lcid: @lcid,
+          user_name: @user_name,
+          pwd: @pwd,
+          app_id: @app_id,
+          app_secret: @app_secret,
+          org_num: @org_num
+        }
+      end
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/model/query_param.rb

@@ -0,0 +1,19 @@
+module K3CloudWebapiSdk
+  module Model
+    class QueryTaskParam
+      attr_accessor :task_id, :cancelled
+      
+      def initialize(task_id = '', is_cancelled = false)
+        @task_id = task_id
+        @cancelled = is_cancelled
+      end
+      
+      def to_h
+        {
+          task_id: @task_id,
+          cancelled: @cancelled
+        }
+      end
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/util/base64_util.rb

@@ -0,0 +1,84 @@
+module K3CloudWebapiSdk
+  module Util
+    module Base64Util
+      CHARSET = ('A'..'Z').to_a.join + ('a'..'z').to_a.join + ('0'..'9').to_a.join + '+/'
+      
+      # Custom base64 encode (Ruby equivalent of Python's base64_util.py)
+      def self.encode(origin_bytes)
+        return '' if origin_bytes.nil? || origin_bytes.empty?
+        
+        # Convert to binary string
+        base64_bytes = origin_bytes.bytes.map { |b| b.to_s(2).rjust(8, '0') }
+        
+        resp = ''
+        nums = base64_bytes.length / 3
+        remain = base64_bytes.length % 3
+        
+        # Process complete 3-byte chunks
+        (0...nums).each do |i|
+          tmp_unit = base64_bytes[i*3..i*3+2].join('')
+          [0, 6, 12, 18].each do |offset|
+            value = tmp_unit[offset, 6].to_i(2)
+            resp << CHARSET[value]
+          end
+        end
+        
+        # Handle remaining bytes
+        if remain > 0
+          remain_part = base64_bytes[nums*3..-1].join('').ljust((3-remain)*8, '0')
+          [0, 6, 12, 18].each_with_index do |offset, idx|
+            break if idx >= remain + 1
+            value = remain_part[offset, 6].to_i(2)
+            resp << CHARSET[value]
+          end
+          resp << '=' * (3 - remain)
+        end
+        
+        resp
+      end
+      
+      # Custom base64 decode
+      def self.decode(base64_str)
+        return [] if !valid_base64_str(base64_str)
+        
+        # Remove padding for processing
+        chars_to_process = base64_str.gsub('=', '')
+        
+        # Convert to 6-bit chunks
+        base64_bytes = chars_to_process.chars.map do |c|
+          CHARSET.index(c).to_s(2).rjust(6, '0')
+        end
+        
+        resp = []
+        nums = base64_bytes.length / 4
+        remain = base64_bytes.length % 4
+        
+        # Process complete 4-chunk units
+        (0...nums).each do |i|
+          tmp_unit = base64_bytes[i*4..i*4+3].join('')
+          [0, 8, 16].each do |offset|
+            value = tmp_unit[offset, 8].to_i(2)
+            resp << value
+          end
+        end
+        
+        # Handle remaining chunks
+        if remain > 0
+          remain_part = base64_bytes[nums*4..-1].join('')
+          (0...remain-1).each do |i|
+            value = remain_part[i*8, 8].to_i(2)
+            resp << value
+          end
+        end
+        
+        resp
+      end
+      
+      # Validate base64 string
+      def self.valid_base64_str(b_str)
+        return false if b_str.length % 4 != 0
+        b_str.each_char.all? { |m| CHARSET.include?(m) }
+      end
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/util/config_util.rb

@@ -0,0 +1,47 @@
+require_relative '../model/api_config'
+
+module K3CloudWebapiSdk
+  module Util
+    module ConfigUtil
+      # Initialize configuration from file
+      def self.init_config(config_path, config_node)
+        raise 'Init config failed: Lack of config path!' if config_path.nil? || config_path.empty?
+        raise 'Init config failed: Lack of config node!' if config_node.nil? || config_node.empty?
+        
+        # For Ruby, we'll use a simple YAML-like format or ENV variables
+        # In a real implementation, you'd use a config file parser
+        assign_api_config = Model::ApiConfig.new
+        
+        # TODO: Implement file parsing for .ini or .yaml files
+        # For now, return empty config
+        assign_api_config
+      end
+      
+      # Initialize configuration by parameters
+      def self.init_config_by_params(acct_id, user_name, app_id, app_secret, server_url, 
+                                   lcid = 2052, org_num = 0, connect_timeout = 120, 
+                                   request_timeout = 120, proxy = '')
+        assign_api_config = Model::ApiConfig.new
+        
+        if !server_url.nil? && !server_url.empty?
+          assign_api_config.server_url = server_url
+        else
+          # Cancel default old gateway, require url input by Ann 2025-01-15
+          raise 'ServerUrl is required'
+        end
+        
+        assign_api_config.dcid = acct_id
+        assign_api_config.user_name = user_name
+        assign_api_config.app_id = app_id
+        assign_api_config.app_secret = app_secret
+        assign_api_config.lcid = lcid > 0 ? lcid : 2052
+        assign_api_config.org_num = org_num > 0 ? org_num : 0
+        assign_api_config.connect_timeout = connect_timeout > 0 ? connect_timeout : 120
+        assign_api_config.request_timeout = request_timeout > 0 ? request_timeout : 120
+        assign_api_config.proxy = proxy
+        
+        assign_api_config
+      end
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/util/encode_util.rb

@@ -0,0 +1,32 @@
+require_relative 'base64_util'
+
+module K3CloudWebapiSdk
+  module Util
+    module EncodeUtil
+      # Decode application secret
+      def self.decode_app_secret(app_secret)
+        return '' if app_secret.length != 32
+        
+        base64_decode = Base64Util.decode(app_secret)
+        base64_xor = xor_code(base64_decode)
+        Base64Util.encode(base64_xor.pack('C*'))
+      end
+      
+      # Encode character using ROT13-like cipher
+      def self.encode_char(ch)
+        if ch =~ /[a-z]/
+          ((ch.ord - 97 + 13) % 26 + 97).chr
+        elsif ch =~ /[A-Z]/
+          ((ch.ord - 65 + 13) % 26 + 65).chr
+        else
+          ch
+        end
+      end
+      
+      # ROT function
+      def self.rot(s)
+        s.chars.map { |c| encode_char(c) }.join('')
+      end
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk/util/hmac_util.rb

@@ -0,0 +1,15 @@
+require 'base64'
+require 'openssl'
+
+module K3CloudWebapiSdk
+  module Util
+    module HmacUtil
+      # Calculate HMAC-SHA256 signature (Ruby equivalent of Python's hmac_util.py)
+      def self.hmac_sha256(content, sign_key, encode_format = 'utf-8')
+        digest = OpenSSL::HMAC.digest('SHA256', sign_key.encode(encode_format), content.encode(encode_format))
+        sign_hex = digest.unpack1('H*')
+        Base64.strict_encode64([sign_hex].pack('H*'))
+      end
+    end
+  end
+end

data/lib/k3cloud_webapi_sdk.rb

@@ -0,0 +1,14 @@
+require 'json'
+require 'rest-client'
+require 'base64'
+require 'openssl'
+require 'securerandom'
+
+# Load all modules
+Dir[File.expand_path('../**/*.rb', __FILE__)].each do |file|
+  require_relative file.sub(/.*\/lib\//, '')
+end
+
+module K3CloudWebapiSdk
+  VERSION = "8.2.0"
+end

metadata

@@ -0,0 +1,110 @@
+--- !ruby/object:Gem::Specification
+name: k3cloud_webapi_sdk
+version: !ruby/object:Gem::Version
+  version: 8.2.0
+platform: ruby
+authors:
+- Converted from Python SDK
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Ruby SDK for K3Cloud API integration
+email:
+- support@kingdee.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/k3cloud_webapi_sdk.rb
+- lib/k3cloud_webapi_sdk/const/const_define.rb
+- lib/k3cloud_webapi_sdk/const/header_param.rb
+- lib/k3cloud_webapi_sdk/core/webapi_client.rb
+- lib/k3cloud_webapi_sdk/main.rb
+- lib/k3cloud_webapi_sdk/model/api_config.rb
+- lib/k3cloud_webapi_sdk/model/cookie.rb
+- lib/k3cloud_webapi_sdk/model/cookie_store.rb
+- lib/k3cloud_webapi_sdk/model/identity.rb
+- lib/k3cloud_webapi_sdk/model/query_param.rb
+- lib/k3cloud_webapi_sdk/util/base64_util.rb
+- lib/k3cloud_webapi_sdk/util/config_util.rb
+- lib/k3cloud_webapi_sdk/util/encode_util.rb
+- lib/k3cloud_webapi_sdk/util/hmac_util.rb
+homepage: https://github.com/kingdee/k3cloud-ruby-sdk
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: K3Cloud API Ruby SDK
+test_files: []