WordPress\AiClient\Providers\Http\Exception

ResponseException{} │ WP 0.1.0└─ RuntimeException

Exception class for HTTP response errors.

This is used when response data is unexpected or malformed, typically indicating that a provider changed in ways our code is not aware of or when parsing response data fails.

No Hooks.

Usage

$ResponseException = new ResponseException();
// use class methods

Methods

1. public static fromInvalidData(string $apiName, string $fieldName, string $message)
2. public static fromMissingData(string $apiName, string $fieldName)

Changelog

ResponseException{} ResponseException{} code ^{WP 7.0}

class ResponseException extends RuntimeException
{
    /**
     * Creates a ResponseException for missing expected data.
     *
     * @since 0.2.0
     *
     * @param string $apiName The name of the API/provider.
     * @param string $fieldName The field that was expected but missing.
     * @return self
     */
    public static function fromMissingData(string $apiName, string $fieldName): self
    {
        $message = sprintf('Unexpected %s API response: Missing the "%s" key.', $apiName, $fieldName);
        return new self($message);
    }
    /**
     * Creates a ResponseException from invalid data in an API response.
     *
     * @since 0.2.0
     *
     * @param string $apiName The name of the API service (e.g., 'OpenAI', 'Anthropic').
     * @param string $fieldName The field that was invalid.
     * @param string $message The specific error message describing the invalid data.
     * @return self
     */
    public static function fromInvalidData(string $apiName, string $fieldName, string $message): self
    {
        return new self(sprintf('Unexpected %s API response: Invalid "%s" key: %s', $apiName, $fieldName, $message));
    }
}