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.
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.
Quickly experience some functions through our gateway:
https://deoss-pub-gateway.cess.cloud Select the GET method.
Enter in the address bar
https://deoss-pub-gateway.cess.cloud/fid（Please replace 'fid' with the actual file unique identifier, such as https://deoss-pub-gateway.cess.cloud/eb46b512283bdbe28108da479497d51b71ed8fc159f953bb9353338849b8f4b9）。We provide several files for testing:
File Unique Identifier(fid) | Document content |
|---|---|
eb46b512283bdbe28108da479497d51b71ed8fc159f953bb9353338849b8f4b9 | Readme file of DeOSS client |
ad6a0687b0b506d866d136e2dba23a6d0d2676fe1de25a5ead77e307b27c66bb | 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 https://deoss-pub-gateway.cess.cloud/ad6a0687b0b506d866d136e2dba23a6d0d2676fe1de25a5ead77e307b27c66bb -H "Operation: download"
Next, we try to view the bucket information for account cXkGyoXtxnK2Zbw8X5gArXi9VGqKqE7b517muih45ds9Ebdno
Use the GET method.
Enter in the address bar:
https://deoss-pub-gateway.cess.cloud/*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 https://deoss-pub-gateway.cess.cloud/* -H "Account: cXkGyoXtxnK2Zbw8X5gArXi9VGqKqE7b517muih45ds9Ebdno"
Let's continue with the above configuration.
Replace the "*" in the URL link with the bucket name, namely https://deoss-pub-gateway.cess.cloud/test-bucket0
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 https://deoss-pub-gateway.cess.cloud/test-bucket0 -H "Account: cXkGyoXtxnK2Zbw8X5gArXi9VGqKqE7b517muih45ds9Ebdno"
Wish to experience more functions? See Getting Started, install the environment, and configure the accounts.
Last modified 1mo ago