This endpoint can be used to fetch publicly available information and content of a shared file or directory knowing its Id, without any authentication. It redirects to the corresponding REST endpoint in one of the supporting Oneproviders. The Oneprovider is chosen dynamically and may change in time, so the redirection URL should not be cached.

The endpoint accepts only identifiers of shared files/directories and will reject requests if a containing share is deleted. The shared file/directory Id can be acquired either by fetching public share details or by listing a shared directory.

The provided query string (if any) is preserved during redirection - consult corresponding Oneprovider REST endpoints for possible options.

Currently, publicly available operations are:

• {...}/$FILE_ID/content - download file or directory content (see Oneprovider REST endpoint)

• {...}/$FILE_ID/children - list directory files and subdirectories (see Oneprovider REST endpoint)

• {...}/$FILE_ID - get basic attributes of a file or directory (see Oneprovider REST endpoint)

• {...}/$FILE_ID/metadata/xattrs - get custom extended attributes (xattrs) associated with a file or directory (see Oneprovider REST endpoint)

• {...}/$FILE_ID/metadata/json - get custom JSON metadata associated with a file or directory (see Oneprovider REST endpoint)

• {...}/$FILE_ID/metadata/rdf - get custom RDF metadata associated with a file or directory (see Oneprovider REST endpoint)

The endpoint will return 503 Service Unavailable when there is no suitable Oneprovider to handle the request and 501 Not Implemented when all available Oneproviders are in versions older than 20.02.*. If an invalid subpath is requested, the target Oneprovider will respond with a proper error.

Example cURL requests

Get shared file or directory data

curl -v -X GET https://$ZONE_HOST/api/v3/onezone/shares/data/$FILE_ID/content

< HTTP/1.1 307 Temporary Redirect
< location: https://provider.example.com/api/v3/oneprovider/data/$FILE_ID/content

# -------------------------------------------------------------------------------

curl -v -X GET https://$ZONE_HOST/api/v3/onezone/shares/data/$FILE_ID/children?limit=3

< HTTP/1.1 307 Temporary Redirect
< location: https://provider.example.com/api/v3/oneprovider/data/$FILE_ID/children?limit=3

# -------------------------------------------------------------------------------

# automatically follow redirects with -L option, request a byte range
curl -L -X GET https://$ZONE_HOST/api/v3/onezone/shares/data/$FILE_ID/content \
-H "Range: bytes=5-8"

fghi