add support for public url

Author: sebastianMindee

lib/mindee/client.rb

@@ -203,6 +203,8 @@ def enqueue_and_parse(
     # @param full_text [Boolean] Whether to include the full OCR text response in compatible APIs.
     #  This performs a full OCR operation on the server and may increase response time.
     #
+    # @param public_url [String, nil] A unique, encrypted URL for accessing the document validation interface without
+    # requiring authentication.
     # @param page_options [Hash, nil] Page cutting/merge options:
     #
     #  * `:page_indexes` Zero-based list of page indexes.
@@ -219,14 +221,16 @@ def execute_workflow(
       document_alias: nil,
       priority: nil,
       full_text: false,
+      public_url: nil,
       page_options: nil
     )
       if input_source.is_a?(Mindee::Input::Source::LocalInputSource) && !page_options.nil? && input_source.pdf?
         input_source.process_pdf(page_options)
       end
 
       workflow_endpoint = Mindee::HTTP::WorkflowEndpoint.new(workflow_id, api_key: @api_key)
-      prediction, raw_http = workflow_endpoint.execute_workflow(input_source, full_text, document_alias, priority)
+      prediction, raw_http = workflow_endpoint.execute_workflow(input_source, full_text, document_alias, priority,
+                                                                public_url)
       Mindee::Parsing::Common::WorkflowResponse.new(Product::Generated::GeneratedV1,
                                                     prediction, raw_http)
     end

lib/mindee/http/workflow_endpoint.rb

@@ -27,10 +27,12 @@ def initialize(workflow_id, api_key: '')
       # @param document_alias [String, nil] Alias to give to the document.
       # @param priority [Symbol, nil] Priority to give to the document.
       # @param full_text [Boolean] Whether to include the full OCR text response in compatible APIs.
+      # @param public_url [String, nil] A unique, encrypted URL for accessing the document validation interface without
+      # requiring authentication.
       # @return [Array]
-      def execute_workflow(input_source, full_text, document_alias, priority)
+      def execute_workflow(input_source, full_text, document_alias, priority, public_url)
         check_api_key
-        response = workflow_execution_req_post(input_source, document_alias, priority, full_text)
+        response = workflow_execution_req_post(input_source, document_alias, priority, full_text, public_url)
         hashed_response = JSON.parse(response.body, object_class: Hash)
         return [hashed_response, response.body] if ResponseValidation.valid_async_response?(response)
 
@@ -43,8 +45,10 @@ def execute_workflow(input_source, full_text, document_alias, priority)
       # @param document_alias [String, nil] Alias to give to the document.
       # @param priority [Symbol, nil] Priority to give to the document.
       # @param full_text [Boolean] Whether to include the full OCR text response in compatible APIs.
+      # @param public_url [String, nil] A unique, encrypted URL for accessing the document validation interface without
+      # requiring authentication.
       # @return [Net::HTTPResponse, nil]
-      def workflow_execution_req_post(input_source, document_alias, priority, full_text)
+      def workflow_execution_req_post(input_source, document_alias, priority, full_text, public_url)
         uri = URI(@url)
         params = {}
         params[:full_text_ocr] = 'true' if full_text
@@ -61,6 +65,7 @@ def workflow_execution_req_post(input_source, document_alias, priority, full_tex
                       [input_source.read_document]
                     end
         form_data.push ['alias', document_alias] if document_alias
+        form_data.push ['public_url', public_url] if public_url
         form_data.push ['priority', priority.to_s] if priority
 
         req.set_form(form_data, 'multipart/form-data')