composer require yasminaai/yasminaai

<?php

namespace Example;

use Yasminaai\YasminaaiClient;
use Yasminaai\Quotes\Requests\PostQuoteRequestsRequest;
use DateTime;

$client = new YasminaaiClient(
    token: '<token>',
);
$client->quotes->requestQuotes(
    new PostQuoteRequestsRequest([
        'otp' => '123456',
        'ownerId' => 'owner_id',
        'phone' => 'phone',
        'birthdate' => new DateTime('2023-01-15'),
        'carEstimatedCost' => 1.1,
    ]),
);

The SDK defaults to the `Sandbox` environment. To use a different environment, pass it to the client constructor:

```php
use Yasminaai\YasminaaiClient;
use Yasminaai\Environments;

$client = new YasminaaiClient(
    token: '<YOUR_TOKEN>',
    options: [
        'baseUrl' => Environments::Staging->value
    ]
);

## Exception Handling

When the API returns a non-success status code (4xx or 5xx response), an exception will be thrown.

```php
use Yasminaai\Exceptions\YasminaaiApiException;
use Yasminaai\Exceptions\YasminaaiException;

try {
    $response = $client->quotes->requestQuotes(...);
} catch (YasminaaiApiException $e) {
    echo 'API Exception occurred: ' . $e->getMessage() . "\n";
    echo 'Status Code: ' . $e->getCode() . "\n";
    echo 'Response Body: ' . $e->getBody() . "\n";
    // Optionally, rethrow the exception or handle accordingly.
}

use Yasminaai\YasminaaiClient;

// Pass any PSR-18 compatible HTTP client implementation.
// For example, using Guzzle:
$customClient = new \GuzzleHttp\Client([
    'timeout' => 5.0,
]);

$client = new YasminaaiClient(options: [
    'client' => $customClient
]);

// Or using Symfony HttpClient:
// $customClient = (new \Symfony\Component\HttpClient\Psr18Client())
//     ->withOptions(['timeout' => 5.0]);
//
// $client = new YasminaaiClient(options: [
//     'client' => $customClient
// ]);

$response = $client->quotes->requestQuotes(
    ...,
    options: [
        'maxRetries' => 0 // Override maxRetries at the request level
    ]
);

$response = $client->quotes->requestQuotes(
    ...,
    options: [
        'timeout' => 3.0 // Override timeout at the request level
    ]
);