README

This guide explains how to interact with the API using the PHP client.

Installation

composer require fortisx/sdk

Initialization

require 'vendor/autoload.php';

use FortisX\SDK\API;

$api = new API('YOUR_API_KEY');

Constructor options

Methods

All requests use GuzzleHttp\Client and automatically include the following headers:

[
  'Authorization' => "Bearer {$apiKey}",
  'Accept' => 'application/json'
]

Error Handling

When a network or server error occurs, an exception of type APIError is thrown.

namespace FortisX\SDK;

class APIError extends \Exception {
    public int $status;
    public array $details;

    public function __construct(string $message, int $status = 0, array $details = []) {
        parent::__construct($message);
        $this->status = $status;
        $this->details = $details;
    }
}

Example:

use FortisX\SDK\API;
use FortisX\SDK\APIError;

$api = new API('demo-key');

try {
    $res = $api->get('ping');
    print_r($res);
} catch (APIError $err) {
    echo "API error [{$err->status}]: {$err->getMessage()}";
} catch (Exception $e) {
    echo "Unexpected error: {$e->getMessage()}";
}

Example: /ping Endpoint

require 'vendor/autoload.php';

use FortisX\SDK\API;

$api = new API('demo-key');
$response = $api->get('ping');

print_r($response); // ['status' => 'ok']