apimatic-core

Introduction

Core library ruby does the job of congregating common and core functionality from ruby SDKs. This includes functionalities like the ability to create HTTP requests, handle responses, apply authentication schemes, convert API responses back to object instances, and validate user and server data.

Installation

You will need 2.6 <= Ruby version <= 3.2 to support this package.

Installation is quite simple, just execute the following command:

gem install apimatic_core

If you'd rather install apimatic_core using bundler, add a line for it in your Gemfile:

gem 'apimatic_core'

API Call Classes

Name	Description
`RequestBuilder`	Builder class used to build an API Request
`APICall`	Class used to create an API Call object
`ResponseHandler`	Used to handle the response returned by the server

Authentication

Name	Description
`HeaderAuth`	Supports HTTP authentication through HTTP Headers
`QueryAuth`	Supports HTTP authentication through query parameters
`AuthGroup`	Helper class to support multiple authentication operation
`And`	Helper class to support AND operation between multiple authentication types
`Or`	Helper class to support OR operation between multiple authentication types
`Single`	Helper class to support single authentication

Configurations

Name	Description
`GlobalConfiguration`	Class holding the global configuration properties to make a successful API Call

Exceptions

Name	Description
`OneOfValidationException`	An exception class for the failed validation of oneOf (union-type) cases
`AnyOfValidationException`	An exception class for the failed validation of anyOf (union-type) cases
`AuthValidationException`	An exception class for the failed validation of authentication schemes

Factories

Name	Description
`HttpResponseFactory`	Factory class to create an HTTP Response

HTTP

Name	Description
`HttpClientConfiguration`	Class used for configuring SDK by a user
`HttpRequest`	Class which contains information about the HTTP Request
`ApiResponse`	Wrapper class for Api Response
`HttpResponse`	Class which contains information about the HTTP Response

Logger

Name	Description
`SdkLogger`	A class responsible for logging request and response of an api call
`NilSdkLogger`	A class responsible for no logging
`ConsoleLogger`	Represents default implementation of logger interface
`ApiLoggingConfiguration`	Represents logging configuration
`ApiRequestLoggingConfiguration`	Represents request logging configuration.
`ApiResponseLoggingConfiguration`	Represents response logging configuration.

Types

Name	Description
`ApiException`	Basic exception type for the SDK
`AnyOf`	Represents the AnyOf union type
`OneOf`	Represents the OneOf union type
`LeafType`	Represents the LeafOf union type
`UnionTypeContext`	Represents the context for a UnionType
`ValidationException`	Exception thrown in case of validation error or failure
`ErrorCase`	A class to represent Exception types
`FileWrapper`	A wrapper to allow passing in content type for file uploads
`Parameter`	A class to represent information about a Parameter passed in an endpoint
`XmlAttributes`	A class to represent information about an XML Parameter passed in an endpoint

Utilities

Name	Description
`ApiHelper`	A Helper Class with various functions associated with making an API Call
`AuthHelper`	A Helper Class with various functions associated with authentication in API Calls
`UnionTypeHelper`	A Helper Class with various functions associated with Union type in API Calls
`ComparisonHelper`	A Helper Class used for the comparison of expected and actual API response
`FileHelper`	A Helper Class for files
`XmlHelper`	A Helper class that holds utility methods for xml serialization and deserialization.