IDiscoveryService.php 812 B

1234567891011121314151617181920212223242526272829303132
  1. <?php
  2. declare(strict_types=1);
  3. /**
  4. * SPDX-FileCopyrightText: 2017 Nextcloud GmbH and Nextcloud contributors
  5. * SPDX-License-Identifier: AGPL-3.0-or-later
  6. */
  7. namespace OCP\OCS;
  8. /**
  9. * Interface IDiscoveryService
  10. *
  11. * Allows you to discover OCS end-points on a remote server
  12. *
  13. * @since 12.0.0
  14. */
  15. interface IDiscoveryService {
  16. /**
  17. * Discover OCS end-points
  18. *
  19. * If no valid discovery data is found the defaults are returned
  20. *
  21. * @since 12.0.0
  22. *
  23. * @param string $remote
  24. * @param string $service the service you want to discover
  25. * @param bool $skipCache We won't check if the data is in the cache. This is useful if a background job is updating the status - Added in 14.0.0
  26. * @return array
  27. */
  28. public function discover(string $remote, string $service, bool $skipCache = false): array;
  29. }