loading zone
/upload/get [GET]
| API Support | Available since | Last updated | Output |
|---|---|---|---|
| 5.9200 | 5.9500 | xml |
Description
Retrieves a file from the loading zone.
Parameters
| Name | Description | Required | Type | Default |
|---|---|---|---|---|
| group | The group for the loading zone | yes | string | |
| path | The path of the file to retrieve (relative to loading zone root) | yes | string | |
| uploadid | An ID to uniquely identify this upload (overrides xlinkid) | no | string | |
| xlinkid | A draft comment ID to attach files to | no | string |
Permission
Must have the role of contributor or higher in the group.
Response
This service returns the file that corresponds to the specified group and path.
The HTTP headers include:
Content-Typebased on the file extension.Last-Modifieduser for HTTP caching based date the file was uploaded.Content-Dispositionset toattachment; filename="[filename]".
This service supports HTTP caching with the If-Modified-Since HTTP header.
Error handling
| HTTP Status | Error condition |
|---|---|
| 400 | The group or path is not specified |
| 400 | If specified, the uploadid or xlinkid is not valid |
| 401 | The user is not authenticated |
| 403 | The user does not have permission to access the path in this group |
| 404 | The specified group does not exist |
| 404 | The specified path does not match any file |