Class: Ingenico::Connect::SDK::Merchant::Files::FilesClient

Inherits:

ApiResource

• Object
• ApiResource
• Ingenico::Connect::SDK::Merchant::Files::FilesClient

Defined in:

lib/ingenico/connect/sdk/merchant/files/files_client.rb

Overview

Files client. Thread-safe.

Instance Attribute Summary

Attributes inherited from ApiResource

#client_meta_info, #communicator

Instance Method Summary

• #get_file(file_id, context = nil) {|Array<Ingenico::Connect::SDK::ResponseHeader>, IO| ... } ⇒ Object

  Resource /{merchantId}/files/{fileId} - Retrieve File.

• #initialize(parent, path_context) ⇒ FilesClient constructor

  A new instance of FilesClient.

Constructor Details

#initialize(parent, path_context) ⇒ FilesClient

Returns a new instance of FilesClient.

Parameters:

• parent (Ingenico::Connect::SDK::ApiResource)
• path_context (Hash)

# File 'lib/ingenico/connect/sdk/merchant/files/files_client.rb', line 19

def initialize(parent, path_context)
  super(parent, path_context)
end

Instance Method Details

#get_file(file_id, context = nil) {|Array<Ingenico::Connect::SDK::ResponseHeader>, IO| ... } ⇒ Object

Resource /{merchantId}/files/{fileId} - Retrieve File

Parameters:

• file_id (String)
• context (Ingenico::Connect::SDK::CallContext) (defaults to: nil)

Yields:

• (Array<Ingenico::Connect::SDK::ResponseHeader>, IO) —

  The response headers and body.

Raises:

• (Ingenico::Connect::SDK::ValidationException) —

  if the request was not correct and couldn’t be processed (HTTP status code 400)

• (Ingenico::Connect::SDK::AuthorizationException) —

  if the request was not allowed (HTTP status code 403)

• (Ingenico::Connect::SDK::IdempotenceException) —

  if an idempotent request caused a conflict (HTTP status code 409)

• (Ingenico::Connect::SDK::ReferenceException) —

  if an object was attempted to be referenced that doesn’t exist or has been removed, or there was a conflict (HTTP status code 404, 409 or 410)

• (Ingenico::Connect::SDK::GlobalCollectException) —

  if something went wrong at the Ingenico ePayments platform, the Ingenico ePayments platform was unable to process a message from a downstream partner/acquirer, or the service that you’re trying to reach is temporary unavailable (HTTP status code 500, 502 or 503)

• (Ingenico::Connect::SDK::ApiException) —

  if the Ingenico ePayments platform returned any other error

# File 'lib/ingenico/connect/sdk/merchant/files/files_client.rb', line 36

def get_file(file_id, context = nil)
  path_context = {
    'fileId'.freeze => file_id,
  }
  uri = instantiate_uri('/files/v1/{merchantId}/files/{fileId}', path_context)
  @communicator.get_with_binary_response(
    uri,
    client_headers,
    nil,
    context) do |headers, response_body|
    yield headers, response_body
  end
rescue ResponseException => e
  error_type = Ingenico::Connect::SDK::Domain::Errors::ErrorResponse
  error_object = @communicator.marshaller.unmarshal(e.body, error_type)
  raise create_exception(e.status_code, e.body, error_object, context)
end