Merge pull request #39315 from nextcloud/feature/openapi/dav

dav: Add OpenAPI spec

Author: provokateurin

apps/dav/lib/Capabilities.php

@@ -5,6 +5,7 @@
  * @author Thomas Müller <thomas.mueller@tmit.eu>
  * @author Louis Chemineau <louis@chmn.me>
  * @author Côme Chilliet <come.chilliet@nextcloud.com>
+ * @author Kate Döen <kate.doeen@nextcloud.com>
  *
  * @license AGPL-3.0
  *
@@ -33,6 +34,9 @@ public function __construct(IConfig $config) {
 		$this->config = $config;
 	}
 
+	/**
+	 * @return array{dav: array{chunking: string, bulkupload?: string}}
+	 */
 	public function getCapabilities() {
 		$capabilities = [
 			'dav' => [

apps/dav/lib/Controller/DirectController.php

@@ -7,6 +7,7 @@
  *
  * @author Iscle <albertiscle9@gmail.com>
  * @author Roeland Jago Douma <roeland@famdouma.nl>
+ * @author Kate Döen <kate.doeen@nextcloud.com>
  *
  * @license GNU AGPL version 3 or any later version
  *
@@ -28,6 +29,7 @@
 
 use OCA\DAV\Db\Direct;
 use OCA\DAV\Db\DirectMapper;
+use OCP\AppFramework\Http;
 use OCP\AppFramework\Http\DataResponse;
 use OCP\AppFramework\OCS\OCSBadRequestException;
 use OCP\AppFramework\OCS\OCSNotFoundException;
@@ -88,6 +90,17 @@ public function __construct(string $appName,
 
 	/**
 	 * @NoAdminRequired
+	 *
+	 * Get a direct link to a file
+	 *
+	 * @param int $fileId ID of the file
+	 * @param int $expirationTime Duration until the link expires
+	 * @return DataResponse<Http::STATUS_OK, array{url: string}, array{}>
+	 * @throws OCSNotFoundException File not found
+	 * @throws OCSBadRequestException Getting direct link is not possible
+	 * @throws OCSForbiddenException Missing permissions to get direct link
+	 *
+	 * 200: Direct link returned
 	 */
 	public function getUrl(int $fileId, int $expirationTime = 60 * 60 * 8): DataResponse {
 		$userFolder = $this->rootFolder->getUserFolder($this->userId);

apps/dav/lib/Controller/InvitationResponseController.php

@@ -8,6 +8,7 @@
  * @author Christoph Wurst <christoph@winzerhof-wurst.at>
  * @author Georg Ehrke <oc.list@georgehrke.com>
  * @author Joas Schilling <coding@schilljs.com>
+ * @author Kate Döen <kate.doeen@nextcloud.com>
  *
  * @license GNU AGPL version 3 or any later version
  *
@@ -29,13 +30,15 @@
 
 use OCA\DAV\CalDAV\InvitationResponse\InvitationResponseServer;
 use OCP\AppFramework\Controller;
+use OCP\AppFramework\Http\Attribute\IgnoreOpenAPI;
 use OCP\AppFramework\Http\TemplateResponse;
 use OCP\AppFramework\Utility\ITimeFactory;
 use OCP\IDBConnection;
 use OCP\IRequest;
 use Sabre\VObject\ITip\Message;
 use Sabre\VObject\Reader;
 
+#[IgnoreOpenAPI]
 class InvitationResponseController extends Controller {
 
 	/** @var IDBConnection */