ClientException::fromClientErrorResponse( WordPressAiClientProvidersHttpDTOResponse $response ): self

Creates a ClientException from a client error response (4xx).

Description

This method extracts error details from common API response formats and creates an exception with a descriptive message and status code.

Parameters

$responseWordPressAiClientProvidersHttpDTOResponserequired: The HTTP response that failed.

Return

self

Source

public static function fromClientErrorResponse(Response $response): self
{
    $statusCode = $response->getStatusCode();
    $statusTexts = [400 => 'Bad Request', 401 => 'Unauthorized', 403 => 'Forbidden', 404 => 'Not Found', 422 => 'Unprocessable Entity', 429 => 'Too Many Requests'];
    if (isset($statusTexts[$statusCode])) {
        $errorMessage = sprintf('%s (%d)', $statusTexts[$statusCode], $statusCode);
    } else {
        $errorMessage = sprintf('Client error (%d): Request was rejected due to client-side issue', $statusCode);
    }
    // Extract error message from response data using centralized utility
    $extractedError = ErrorMessageExtractor::extractFromResponseData($response->getData());
    if ($extractedError !== null) {
        $errorMessage .= ' - ' . $extractedError;
    }
    return new self($errorMessage, $statusCode);
}

View all references View on Trac View on GitHub

Uses	Description
ErrorMessageExtractor::extractFromResponseData()`wp-includes/php-ai-client/src/Providers/Http/Util/ErrorMessageExtractor.php`	Extracts error message from API response data.

Used by	Description
ResponseUtil::throwIfNotSuccessful()`wp-includes/php-ai-client/src/Providers/Http/Util/ResponseUtil.php`	Throws an appropriate exception if the given response is not successful.

Changelog

Version	Description
0.2.0	Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.