4shared.com - free file sharing and storage

REST API

Basics

Introduction
Public calls
Formats
Global request parameters
Pagination
Filtering
Authentication
Error handling

Resources

/user
/users
/folders
/files

API console

SOAP API

Basics

Introduction
Sources
Quick start guide

Samples

Java
PHP
iOS
Symbian (QT)
Android
Blackberry

How To

Upload
Search

Server methods:

Account

signup
signupUsername
login
isAccountActive
isAccountPremium
isAccountBanned
isExistsLoginPassword

Upload

hasRightUpload
getMaxFileSize
getFreeSpace
getSpaceLimit
getUploadFormUrl
getNewFileDataCenter
createUploadSessionKey
uploadStartFile
uploadStartFileUpdate
uploadStartedFileExists
uploadCancelFile
uploadFinishFile

File

getFiles
setFileDescription
getFileDescription
renameFile
deleteFile
deleteFileFinal
restoreFile
restoreFiles
getFileInfo
getExifFileInf
getExifFileInfos
getMp3FileInfo
getMp3FileInfos
getPreviewLink
getVideoPreviewLink

Folder

createNewFolder
setDirDescription
getDirDescription
renameFolder
deleteFolder
deleteFolderFinal
emptyRecycleBin
getDirInfo
getRoot
getAllFolders
getHistory
getHistoryFromId
markSynchronized
getOperationDescriptions

Items (Files or folders)

getItemInfo
getItems
getAllItems
getItemsPartial
getItemsCount
getSharedDirItems
getRecycleBinItems
pasteFilesDirs
decodeId
decodeLink

Download

getDirectLink
getFileDownloadLink
downloadFinished
getNotOwnedSizeLimit

addToFavorites
removeFromFavorites
getFavorites
addToMyAccount
checkSubdomain
checkSharedDirAccess
setFolderSharingProperties
getFolderSharingProperties

Misc

getCurrentUploaderVersion syncFinished

My Application

addToFavorites

long addToFavorites(java.lang.String login,
java.lang.String password,
long fileId)

Adds file to user favorites.

removeFromFavorites

long removeFromFavorites(java.lang.String login,
java.lang.String password,
long fileId)

Removes file from user's favorites.

getFavorites

AccountItem[] getFavorites(java.lang.String login,
java.lang.String password)

Returns user favored files.

addToMyAccount

ava.lang.String addToMyAccount(java.lang.String login,
java.lang.String password,
long dirId,
java.lang.String link)

Adds file or folder identified by supplied link to user's account in folder identified by dirId.

checkSubdomain

public java.lang.String checkSubdomain(java.lang.String login,
java.lang.String password,
long dirId,
java.lang.String subdomainName)

Checks if subdomain can be set for specified folder.

Parameters:

Returns:

Empty string or null if everything is ok and error message otherwise

checkSharedDirAccess

public int checkSharedDirAccess(java.lang.String login,
java.lang.String password,
long dirID,
java.lang.String dirPassword,
java.lang.String userDirPassword)

Checks if directory can be accessed by specified user with specified passwords.

Parameters:

login - is user login
password - is user password
dirID - id of the directory to be accessed
dirPassword - generated password to view contents of not owned folders
userDirPassword - user specified password

Returns:

Status.
0 ok
1 no such dir
2 owner inactive
3 abused dir
4 incorrect dirPassword
5 dir is not shared
6 owner is banned
8 incorrect userDirPassword

setFolderSharingProperties

public java.lang.String setFolderSharingProperties(java.lang.String login,
java.lang.String password,
long dirId,
com.pmstation.shared.soap.api.SharedFolderProperties folderProperties)

Sets folder sharing properties.

Parameters:

login - user login
password - user password
dirId - id of folder to set properties for
folderProperties - new properties values

Returns:

Diagnostic message or empty string if all is ok

getFolderSharingProperties

public com.pmstation.shared.soap.api.SharedFolderProperties[] getFolderSharingProperties(java.lang.String login,
java.lang.String password,
long dirId)

Returns folder sharing properties. Output is two element array: res[0] - actual values. res[1] - properties which can be set for this user is marked as true.

Parameters:

Returns:

folder sharing properties