bc-consulting/tuning-api-client

Tuning Api Client

v1.0.3 2025-04-22 14:09 UTC

Requires

• php: ^7.0
• guzzlehttp/guzzle: ^6.3

Requires (Dev)

• orchestra/testbench: ~3.7

MIT

• Miguel De Buf

README

The bc-consulting/tuning-api-client package is a library that eases integration of the B&C Consulting Tuning database API in your site.

Installation

Install the package via composer:

composer require bc-consulting/tuning-api-client

Usage

Configure the TuningApiClient and use the Models:

use \BcConsulting\TuningApiClient\TuningApiClient;

TuningApiClient::config([
	'api_token' => 'my-token',
	'api_url' => 'https://tuning-api-staging.bcconsulting.lu',
]);
print_r(TuningApiClient::vehicles());
print_r(TuningApiClient::vehicles(1));
print_r(TuningApiClient::vehicles(1)->brands());
print_r(TuningApiClient::vehicles(1)->brands(5));
print_r(TuningApiClient::vehicles(1)->brands(5)->models());
print_r(TuningApiClient::vehicles(1)->brands(5)->models(5359));
print_r(TuningApiClient::vehicles(1)->brands(5)->models(5359)->years());
print_r(TuningApiClient::vehicles(1)->brands(5)->models(5359)->years(8163));
print_r(TuningApiClient::vehicles(1)->brands(5)->models(5359)->years(8163)->powertrains());
print_r(TuningApiClient::vehicles(1)->brands(5)->models(5359)->years(8163)->powertrains(8165));

In case you have a premium subscription, then you also have access to these methods to retrieve brand logo and miniatures:

print_r(TuningApiClient::vehicles(1)->brands(5)->logo());
print_r(TuningApiClient::vehicles(1)->brands(5)->models(508)->miniature());
print_r(TuningApiClient::vehicles(1)->brands(5)->models(5359)->years(8163)->miniature());
print_r(TuningApiClient::vehicles(1)->brands(5)->models(5359)->years(8163)->powertrains(8165)->miniature());

In case of an error, the api throws a BcConsulting\TuningApiClient\Exceptions\TuningApiException. This exception inherits from \Exception and additionally has these methods :

• getStatusCode() : returns the HTTP status code received
• getData() : returns an array with more exception specific details

$e->getMessage()
$e->getCode()
$e->getStatusCode()
$e->getData()

Help and docs

• API Documentation

License

MIT