Difference between revisions of "StorageHub REST API"
From Gcube Wiki
Lucio.lelii (Talk | contribs) (→API) |
Lucio.lelii (Talk | contribs) (→Retrieve Worksapce) |
||
Line 18: | Line 18: | ||
== API == | == API == | ||
− | = Retrieve | + | == Retrieve Workspace == |
+ | |||
+ | Returns the Item representing the workspace of the user retrieved by the token used for the call. | ||
+ | |||
+ | === java === | ||
+ | <source lang="java"> | ||
+ | StorageHubClient shc = new StorageHubClient(); | ||
+ | FolderContainer rootContianer = shc.getWSRoot() | ||
+ | </source> | ||
+ | |||
+ | === REST API === | ||
+ | |||
+ | GET /workspace/?gcube-token={user-token} | ||
+ | |||
+ | ==== responses ==== | ||
+ | |||
+ | 200 The workspace root item (in json format) is returned. | ||
+ | |||
+ | 400 The error is specified in the body of the response message | ||
= Create Folder = | = Create Folder = |
Revision as of 11:50, 12 November 2018
Contents
Overview
The StorageHub REST interface provides a simple access to basic SH features.
Key features
Users must use the personal to access the REST interface. They can access just their own files and the folders shared with them.
StorageHub REST interface supports the following operations:
- Retrieve WS: to retrieve the user Workspace;
- Create Folder: to create a folder in the given parent folder;
- Delete: to remove a file or a folder (including subfolders);
- Download: to download a file or a folder in ZIP format;
- Get Public Link: to get a public link of a file;
- List: to list the content of a folder;
- Unzip: to upload a zip file in a specific folder;
- Upload file: to upload a file in a folder.
API
Retrieve Workspace
Returns the Item representing the workspace of the user retrieved by the token used for the call.
java
StorageHubClient shc = new StorageHubClient(); FolderContainer rootContianer = shc.getWSRoot()
REST API
GET /workspace/?gcube-token={user-token}
responses
200 The workspace root item (in json format) is returned.
400 The error is specified in the body of the response message