Error Handling

\RuntimeException
└── Law4DevsException          base — any SDK error
    ├── NotFoundError          404 — resource not found
    ├── ValidationError        400 — invalid parameters
    ├── RateLimitError         429 — rate limit exceeded
    └── ServerError            5xx — server-side error

try {
    $article = $client->articles->get('gdpr', 9999);
} catch (\Law4Devs\Exceptions\NotFoundError $e) {
    echo 'Not found: ' . $e->getMessage() . "\n";  // message from API
    echo 'Status: ' . $e->statusCode . "\n";        // 404
}

use Law4Devs\Exceptions\Law4DevsException;
use Law4Devs\Exceptions\NotFoundError;
use Law4Devs\Exceptions\RateLimitError;
use Law4Devs\Exceptions\ValidationError;

try {
    $page = $client->articles->list('invalid-framework');
} catch (NotFoundError $e) {
    // Framework not found
    echo 'Framework not found: ' . $e->getMessage() . "\n";
} catch (ValidationError $e) {
    // Bad request parameters
    echo 'Invalid request: ' . $e->getMessage() . "\n";
} catch (RateLimitError $e) {
    // Retry after a delay (SDK already retried 3 times)
    echo 'Rate limit hit: ' . $e->getMessage() . "\n";
} catch (Law4DevsException $e) {
    // All other SDK errors (server errors, network failures)
    echo 'SDK error (' . $e->statusCode . '): ' . $e->getMessage() . "\n";
}

$client = new \Law4Devs\Client(
    apiKey:     getenv('LAW4DEVS_API_KEY'),
    maxRetries: 0,
);

use Law4Devs\Exceptions\Law4DevsException;

try {
    $page = $client->frameworks->list();
} catch (Law4DevsException $e) {
    if ($e->statusCode === null) {
        echo 'Network error: ' . $e->getMessage() . "\n";
    }
}