Quick Experience

DeOSS complies to REST API specifications and uses HTTP to access the CESS cloud storage service interface. The developer can download the source code as needed and deploys it on any server. To facilitate developers to get started quickly, DeOSS provides a public gateway service for testing.

Prepare the test

This Quick Start Guide uses the Postman plug-in of Chrome browser to demonstrate sending HTTP requests.
You can also choose other ways to operate, such as using browser developer tools or command line tools, Linux users can use curl, etc.
Open a Chrome browser; install and open the Tabbed Postman plug-in.

Fast experience

Quickly experience some functions through our gateway:

Download files

Select the GET method.
Enter in the address bar replace 'fid' with the actual file unique identifier, such as
We provide several files for testing:
File Unique Identifier(fid)
Document content
Readme file of DeOSS client
GitHub home page of the DeOSS server
Set the header's key-value, KEY=Operation, VALUE=download.
Click the "Send" button to download, as shown in Figure 1.
Figure 1 Download files using Postman
DeOSS supports any file storage forms. You can refer to the operation guide to use DeOSS to manage your file resources.
You can use the curl command to test the above steps, such as downloading and saving deoss.html
curl -X GET -o deoss.html -H "Operation: download"

View bucket information

Next, we try to view the bucket information for account cXkGyoXtxnK2Zbw8X5gArXi9VGqKqE7b517muih45ds9Ebdno
Use the GET method.
Enter in the address bar:*
Set the header's key-value, KEY = Account, VALUE = cXkGyoXtxnK2Zbw8X5gArXi9VGqKqE7b517muih45ds9Ebdno。
Click the "Send" button to view the bucket information of the account, as shown in Figure 2.
Figure 2 View the account bucket list
From the response, we can see that this account only created one bucket with the name "test-bucket0".
Use the curl command to query the information, such as:
curl -X GET* -H "Account: cXkGyoXtxnK2Zbw8X5gArXi9VGqKqE7b517muih45ds9Ebdno"

View objects in the bucket

Let's continue with the above configuration.
Replace the "*" in the URL link with the bucket name, namely
Click the "Send" button to view which files are stored in the bucket, as shown in Figure 3.
Figure 3 Viewing bucket File information
In the response, "Num" indicates that there are 2 files in the bucket, and "Files" shows the unique identifiers of each file, namely fid.
Use the curl command to query this information
curl -X GET -H "Account: cXkGyoXtxnK2Zbw8X5gArXi9VGqKqE7b517muih45ds9Ebdno"
Wish to experience more functions? See Getting Started, install the environment, and configure the accounts.