mirror of
https://github.com/nextcloud/server.git
synced 2026-06-28 18:11:31 -04:00
4d56c74ba7
Co-authored-by: Micke Nordin <kano@sunet.se> Signed-off-by: Micke Nordin <kano@sunet.se> Signed-off-by: Enrique Pérez Arnaud <enrique@cazalla.net>
33 lines
1 KiB
PHP
33 lines
1 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
/**
|
|
* SPDX-FileCopyrightText: 2026 Nextcloud GmbH and Nextcloud contributors
|
|
* SPDX-License-Identifier: AGPL-3.0-or-later
|
|
*/
|
|
|
|
namespace OCP\Federation;
|
|
|
|
use OCP\Federation\Exceptions\BadRequestException;
|
|
use OCP\Federation\Exceptions\ProviderCouldNotAddShareException;
|
|
|
|
/**
|
|
* Optional extension of {@see ICloudFederationProvider} for providers that
|
|
* can validate an incoming share envelope without producing side effects.
|
|
*
|
|
* @since 34.0.0
|
|
*/
|
|
interface IValidationAwareCloudFederationProvider extends ICloudFederationProvider {
|
|
/**
|
|
* Validate the share envelope. Implementations MUST NOT produce
|
|
* persistent side effects from this method.
|
|
*
|
|
* @throws BadRequestException If the envelope is structurally invalid.
|
|
* @throws ProviderCouldNotAddShareException For other rejections; the
|
|
* exception's code is used as the HTTP status.
|
|
*
|
|
* @since 34.0.0
|
|
*/
|
|
public function validateShare(ICloudFederationShare $share): void;
|
|
}
|