Downloading Content
This guide will walk you through retrieving content from Grove.
All uploaded contents are world-public readable. Privacy-settings will be implemented in the future.
Direct Download
Given a gateway URL (https://api.grove.storage/af5225b…), you can can simply use it to download the file.
Resolving Lens URIs
Given a lens://af5225b… URI, you can resolve its content to a URL.
- TypeScript
- Others
Use the resolve method to get the URL:
Example
const url = storageClient.resolve("lens://af5225b…");
// url: https://api.grove.storage/af5225b…Retrieving Partial Content
The Grove API supports HTTP range requests to retrieve only partial contents of a file.
For example, this command will download only the first 1024 bytes of a file.
Example
curl -H 'Content-Range: bytes=0-1023' \ 'https://api.grove.storage/af5225b6262e03be6bfacf31aa416ea5e00ebb05e802d0573222a92f8d0677f5'If the file is a video, you can use the link directly inside the <video> HTML tag:
Video Example
<video width="640" height="480"> <source src="https://api.grove.storage/af5225b…" type="video/mp4" /></video>When you move the slider of the video player, the browser will send the appropriate range requests to the Grove API, allowing the video to resume from that point without downloading the entire file.