LogoLogo
  • Welcome to DeOSS Guide !
  • Introduction
    • Terminologies
    • System Architecture
    • Data Access Process
  • Product Pricing
  • Get Started
    • Configure CESS Account
    • DeOSS Gateway
      • Set up your Own Gateway
      • Step 1: Create a Bucket
      • Step 2: Upload an Object
      • Step 3: Download an Object
      • Step 4: Delete the Object and Buckets
    • GO-SDK
      • Preface
      • Initialize SDK
      • SDK client properties
        • View signature account
        • View the public key of the signing account
        • Check the connected RPC address
        • View sdk name
        • View signature account mnemonic phrase
      • File operation related
        • Storage space operations related
          • Buy space
          • Expansion space
          • Renewal space
          • Authorized space
          • Cancel authorization space
        • Bucket creation
        • Upload local file
        • Upload object
        • Upload file stream
        • File download
        • File delete
        • File encryption
        • File decryption
        • File specification processing
      • Chain operation related
        • Chain status
          • View DeOSS list
          • View all storage node accounts
          • View storage node details
          • View user space details
          • View account details
          • View token symbols
          • View block synchronization information
          • View chain version number
        • Chain transaction
          • Create storage order
          • Transfer
    • JS-SDK
      • General Usage
      • Bucket Operation
      • File Operation
      • Space Operation
      • Auth Operation
      • API library
    • Rust-SDK
      • Initialize SDK
      • Buy Space
      • Authorize Space
      • Bucket Creation
      • File Upload
      • File Download
      • File Encryption
      • File Decryption
  • API Reference
    • Introduction
    • Identity signature
    • Working with Objects
      • PutObject
      • GetObject
      • DeleteObject
      • GetObjectInfo
    • Working with Buckets
      • PutBucket
      • GetBucket
      • DeleteBucket
      • ListBucket
Powered by GitBook
On this page
  • Interface description
  • Request Syntax
  1. API Reference
  2. Working with Objects

GetObject

PreviousPutObjectNextDeleteObject

Last updated 1 year ago

Interface description

Download the file with specified fid.

Request Syntax

GET -o fileName GatewayURL/fid

Note: - o is optional in specifying the file name to be downloaded. If this item is ignored, the fid of this file will be used as the file name.

Request Header

Key
Value

Operation

download

cipher

the key used to decrypt the file

Don't forget to add your to the header.

Response

Response format: application/octet-stream, Response format for exception return status: application/json

Status code
Message
Response description

400

InvalidHead.Operation

Wrong operation

403

BackingUp

Files are being backed up

404

NotFound

File not found

500

InternalError

Server internal error

Request example

Request to download the file with fid as c8a92e3b66ab1ecf1fba3b6355ce6e76a216d7b93b76097a9f2f2e20b3fc0761, and save the file with name as “samplefile”

# curl -X GET -o samplefile URL/fid -H "Operation: download"

Response example

identity signature