README

The Symfony BusinessCentral HTTP Client, BusinessCentralHttpClient, is designed to simplify HTTP requests to BusinessCentral services with added headers and authentication.

Table of Contents

• Introduction
• Installation
• Usage
• Configuration

Introduction

The BusinessCentralHttpClient class is a Symfony component that enhances the standard Symfony HttpClient. It adds headers, authentication credentials, and custom options for making requests to BusinessCentral services.

Installation

To use the Symfony BusinessCentral HTTP Client in your project, you can include it via Composer.

composer require fittinq/symfony-BusinessCentral

Usage

To use the BusinessCentralHttpClient, follow these steps:

1. Create an instance of the BusinessCentralHttpClient class, providing it with the required dependencies: HttpClientInterface, username, password, and API key.

   use Fittinq\Symfony\BusinessCentral\BusinessCentralHttpClient;
   use Symfony\Contracts\HttpClient\HttpClientInterface;
   
   $httpClient = new HttpClient(); // Replace with your actual HttpClient instance.
   $username = '%env(BUSINESS_CENTRAL_USERNAME)%';
   $password = '%env(BUSINESS_CENTRAL_PASSWORD)%';
       
   $businessCentralHttpClient = new BusinessCentralHttpClient($httpClient, $username, $password, $apiKey);
   

2. You can use the request method to send HTTP requests to BusinessCentral services. It automatically adds headers for Content-Type, login, password, and apiKey.

   $url = 'https://businessCentral-service-url';
   $options = ['headers' => ['custom-header' => 'value']];
       
   $response = $businessCentralHttpClient->request('GET', $url, $options);
   

Configuration

Add the following parameters to your environment

BUSINESSCENTRAL_USERNAME=
BUSINESSCENTRAL_PASSWORD=