GET:files/{fileid}

Overview

public. Retrieve file attachment content

Message Format

None

Implementation Notes

Use of the format, ratio, width/height, and size parameters requires the file to be an image. 

The Content-Disposition, Content-Length, and Content-Type headers provide information about the retrieved file.

Use GET:files to retrieve a list of files across the site or GET:pages/{pageid}/files to retrieve the files on a specified page.

Code Samples

The following code example retrieves the file with ID 456 using a best fit of 100x100 and saves it in the caller's temporary directory:

Plug p = Plug.New("http://deki-hayes/@api/deki");
p.At("users", "authenticate").WithCredentials("admin", "password").Get();
DreamMessage msg = p.At("files", "456")
                    .With("size", "bestfit")
                    .With("width", 100)
                    .With("height", 100).Get();
using (FileStream fs = System.IO.File.OpenWrite(Path.GetTempPath() + msg.ContentDisposition.FileName)) 
{
    byte[] fileData = msg.AsBytes();
    fs.Write(fileData, 0, fileData.Length);
}