HEAD:files/{fileid}/{filename}

1. Overview
1. 1. 1. 1.1.1.1. Uri Parameters
    2. 1.1.1.2. Query Parameters
    3. 1.1.1.3. Return Codes
2. Message Format
3. Implementation Notes
4. Code Samples

Overview

public. Retrieve file attachment content (Note: image manipulation arguments are ignored for HEAD requests)

Uri Parameters

Name	Type	Description
fileid	int	identifies a file by ID
filename	string	"=" followed by a double uri-encoded file name

Query Parameters

Name	Type	Description
format	{jpg, png, bmp, gif}?	Convert output to given type. Default is to use original type.
height	int?	Height of the image
ratio	{fixed, var}?	Fixed preserves aspect ratio by applying height and width as bounding maximums rather than absolute values. Variable will use the width and height given. Default: fixed
redirects	int?	If zero, do not follow page redirects (only applies when {pageid} is present).
revision	string?	File revision to retrieve. 'head' by default will retrieve latest revision. positive integer will retrieve specific revision
size	{original, thumb, webview, bestfit, custom}?	Return a resized image from one of the preset cached sizes. Use 'thumb' or 'webview' to return a smaller scaled image. Use 'bestfit' along with height/width to return one of the known sizes being at least the size given. Default: original
width	int?	Width of the image

Return Codes

Name	Value	Description
BadRequest	400	Invalid input parameter or request body
Forbidden	403	Read access to the page is required
NotFound	404	Requested file could not be found
NotImplemented	501	Requested operation is not currently supported
Ok	200	The request completed successfully

Message Format

None

Implementation Notes

This feature is identical to HEAD:files/{fileid}; refer to this feature for more information. The {filename} uri parameter is not used and is intended for informational purposes only.

Code Samples

None

Retrieved from "http://wiki.developer.mindtouch.com/index.php?title=MindTouch_Deki/API_Reference/HEAD:files%2F%2F%7Bfileid%7D%2F%2F%7Bfilename%7D"

Tag page
What links here

Files 0

Attach file or image

Images 0

You must login to post a comment.