|
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: ""
}
|
|
