Merge pull request #34285 from nextcloud/backport/34263/stable25

[stable25] Add endpoint to fetch a cachable reference data

Author: blizzz

core/Controller/ReferenceApiController.php

@@ -57,6 +57,16 @@ public function extract(string $text, bool $resolve = false, int $limit = 1): Da
 		]);
 	}
 
+	/**
+	 * @NoAdminRequired
+	 */
+	public function resolveOne(string $reference): DataResponse {
+		$resolvedReference = $this->referenceManager->resolveReference($reference);
+
+		$response = new DataResponse(['references' => [ $reference => $resolvedReference ]]);
+		$response->cacheFor(3600, false, true);
+		return $response;
+	}
 
 	/**
 	 * @NoAdminRequired

core/routes.php

@@ -123,6 +123,7 @@
 		['root' => '/collaboration', 'name' => 'CollaborationResources#getCollectionsByResource', 'url' => '/resources/{resourceType}/{resourceId}', 'verb' => 'GET'],
 		['root' => '/collaboration', 'name' => 'CollaborationResources#createCollectionOnResource', 'url' => '/resources/{baseResourceType}/{baseResourceId}', 'verb' => 'POST'],
 
+		['root' => '/references', 'name' => 'ReferenceApi#resolveOne', 'url' => '/resolve', 'verb' => 'GET'],
 		['root' => '/references', 'name' => 'ReferenceApi#extract', 'url' => '/extract', 'verb' => 'POST'],
 		['root' => '/references', 'name' => 'ReferenceApi#resolve', 'url' => '/resolve', 'verb' => 'POST'],