Resources
/user
/user |
Description |
Retrieves information about the current user's account. |
Method |
GET |
Returns |
{
id: "",
email: "",
plan: "Premium",
firstName: "",
lastName: "",
description: "",
freeSpace: 0,
uploadFileSizeLimit: 0,
rootFolderId: "",
profileUrl: ""
}
|
/user |
Description |
Updates current user's information. |
Method |
PUT |
Params |
firstName, lastName, description |
Returns |
{
id: "",
email: "",
plan: "Premium",
firstName: "",
lastName: "",
description: "",
freeSpace: 0,
uploadFileSizeLimit: 0,
rootFolderId: "",
profileUrl: ""
}
|
/user/files |
Description |
Retrieves the list of current user's files. The files are ordered by the upload date. Use filtering to make the request more specific. |
Method |
GET |
Returns |
{
files: [
{/* File response */}
}
}
|
/users
/users/{id} |
Description |
Retrieves information about the user's account. |
Method |
GET |
Returns |
|
/folders
/folders/{id} |
Description |
Retrieves information about the folder. |
Method |
GET |
Returns |
{
id: "",
name: "",
description: "",
size: 1024,
path: "/a/b/c",
modified: "Mon Sep 17 15:41:18 UTC 2012",
shared: true/false,
numChildren: 0,
numFiles: 10,
ownerId: ""
}
|
/folders/{id}/children |
Description |
Retrieves the list of folder's immediate children. |
Method |
GET |
Returns |
{
folders: [
{/* Folder response */}
]
}
|
/folders/{id}/files |
Description |
Retrieves the list of files in folder. |
Method |
GET |
Returns |
{
files: [
{/* File response */}
]
}
|
/folders |
Description |
Creates a folder |
Method |
POST |
Params |
parentId - parent folder's id
name - folder's name
description - folder's description
|
Returns |
{
/* Folder response */
}
|
/folders/{id} |
Description |
Updates the folder info |
Method |
PUT |
Params |
name, description, shared (true/false, only for folder's owner)
|
Returns |
{
/* Folder response */
}
|
/folders/{id} |
Description |
Deletes the folder |
Method |
DELETE |
Returns |
{
ok: true/false,
message: ""
}
|
/files
/files/{id} |
Description |
Retrieves the file information. |
Method |
GET |
Returns |
{
"id": "",
"name": "",
"type": "JPEG Image",
"size": 64307,
"modified": "Mon Sep 17 15:41:18 UTC 2012",
"tags": [
"tag1",
"tag2",
"tag3"
],
"path": "/a/b/c,
"thumbnailUrl": "",
"downloadUrl": "",
"downloadPage": "",
"ownerId": "",
"hash": "1165984590"
"mimeType":""
}
|
/files/{id}/exif |
Description |
Get the EXIF tags for a given files. Returns empty response if the file doesn't have EXIF data. Updating EXIF tags isn't possible via API. EXIF tags are updated automatically during file upload or update. |
Method |
GET |
Returns |
{
"model": "",
"make": "",
"dateTimeOriginal": "2012:08:18 14:52:46",
"width": "3264 pixels",
"height": "2448 pixels",
"latitude": "49.84000002555556",
"longitude": "24.03183333333333",
"latitudeRef": "N",
"longitudeRef": "E"
}
|
/files |
Description |
Retrives list of public files ordered by date. Use filtering to make the request more specific. |
Method |
GET |
Returns |
{
files: [
{/* File response */}
]
}
|
/files |
Description |
Uploads a file. |
Method |
POST (Content-Type: multipart/form-data) |
Params |
folderId - folder's id
description - file description
tags - comma separated values
file - file
|
Returns |
|
/files/{id} |
Description |
Updates the file. |
Method |
PUT (Content-Type: multipart/form-data) |
Params |
file - binary file
|
Returns |
|
/files/{id} |
Description |
Updates the file's info. |
Method |
PUT (Content-Type: application/x-www-form-urlencoded) |
Params |
name, description, tags (comma separated values)
|
Returns |
|
/files/{id} |
Description |
Deletes the file. |
Method |
DELETE |
Returns |
{
ok: true/false,
message: ""
}
|
|