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

hasRightUpload

public boolean hasRightUpload()

Whether upload feature is on.

Returns:

whether upload feature is on.

getMaxFileSize

public long getMaxFileSize(java.lang.String login, java.lang.String password)

Return maximum allowed file size for specified user.

Parameters:

Returns:

maximum allowed file size in bytes

getFreeSpace

public long getFreeSpace(java.lang.String login, java.lang.String password)

Gets free space left for user.

Parameters:

Returns:

free space left for user in bytes

getSpaceLimit

public long getSpaceLimit(java.lang.String login, java.lang.String password)

Returns user space limit.

Parameters:

Returns:

space limit

getUploadFormUrl

public java.lang.String getUploadFormUrl(int dataCenterID, java.lang.String sessionKey)

Returns url to upload file to.

Parameters:

dataCenterID - id of datacenter to upload to
sessionKey - upload session key

getNewFileDataCenter

public long getNewFileDataCenter(java.lang.String login, java.lang.String password)

Returns datacenter id to upload files to.

Parameters:

Returns:

datacenter id to upload new files to

createUploadSessionKey

public java.lang.String createUploadSessionKey(java.lang.String login, java.lang.String password, long dirID)

Creates session key for uploading file.

Parameters:

Returns:

session key

uploadStartFile

public long uploadStartFile(java.lang.String login, java.lang.String password, long dirID, java.lang.String name, long fullSize)

Resumable upload - start.

Parameters:

dirID - (-1) means upload to user's root dir

Returns:

fileId to pass as parameter in all subsequent partial uploads

uploadStartFileUpdate

public long uploadStartFileUpdate(java.lang.String login, java.lang.String password, long updateFileId, java.lang.String name, long fullSize)

Update file.

Parameters:

login - user login
password - user password
updateFileId - it of original file to be updated
name - empty string means don't change existing name
fullSize -

Returns:

id of temporary file uploading of which will cause update of original file

uploadStartedFileExists

public boolean uploadStartedFileExists(java.lang.String login, java.lang.String password, long fileId)

Checks if file was partially uploaded.

Parameters:

Returns:

true if there is part of file already uploaded.

uploadCancelFile

public void uploadCancelFile(java.lang.String login, java.lang.String password, long fileId)

Call if upload was canceled.

Parameters:

uploadFinishFile

public java.lang.String uploadFinishFile(java.lang.String login, java.lang.String password, long fileId, java.lang.String md5)

Complete resumable upload.

Parameters:

login - user login
password - user password
fileId - returned from initial call to uploadStartFile() - existing file in 'being uploaded by parts' state
md5 - original file MD5 to verify file consistency at server side

Returns:

empty string if success or error message