AbstractApiProvider

16abstract class AbstractApiProvider extends AbstractProvider17{18    /**19     * Gets the base URL for the provider's API.20     *21     * The base URL should include the protocol and domain, and may include22     * the API version path (e.g., "https://api.example.com/v1").23     *24     * @since 0.2.025     *26     * @return string The base URL for the provider's API.27     */28    abstract protected static function baseUrl(): string;29    /**30     * Constructs a full URL by combining the base URL with an optional path.31     *32     * This method ensures proper URL construction by:33     * - Using the provider's base URL34     * - Trimming leading slashes from the path to prevent double-slashes35     * - Joining the base URL and path with a single forward slash36     *37     * @since 0.2.038     *39     * @param string $path Optional path to append to the base URL. Default empty string.40     * @return string The complete URL.41     */42    public static function url(string $path = ''): string43    {44        if ($path === '') {45            return static::baseUrl();46        }47        return static::baseUrl() . '/' . ltrim($path, '/');48    }49}