Upload1.4

Upload Guide

General Information

Instant

• 'Instant' simply means that the file you want to upload already exists in our system. Instead of wasting bandwidth and time uploading the full file we simply make a copy of the file already in the cloud.
• This upload method is preferred when it is available.
• A call to upload/check is necessary to determine if a file can be uploaded via this method.
• It is not possible to perform an instant upload if the file already in our system has a legacy MD5 hash.

Single-Chunk

• 'Single-chunk' refers to the method of uploading a file all at once in a single 'session'. Upload/simple, upload/update, upload/patch, and upload/add_web_upload all upload files in this manner. Upload/resumable uploads files in this manner when the file is 4MB or less.
• A single-chunk upload cannot be resumed if the upload is interrupted. It must start over from the beginning.

Multi-Chunk

• 'Multi-chunk' refers to the method of slicing a file into chunks(units) and uploading each chunk(unit) separately. This method is used by upload/resumable in order to upload files over 4MB.
  
• A multi-chunk upload can be resumed if the upload is interrupted.
  
• This upload method is preferred for medium to large files.
  

Helpful Tips

• The following APIs must be POST requests as they require the binary contents of a file to be provided: upload/simple, upload/patch, upload/update, and upload/resumable.
• All other upload API methods can be either GET or POST.
• The POST body should only contain the binary file data.
• Any other parameters passed to the API method, that are not headers, should be included in the URL Query String such as with a GET request.
• All parameters that begin with 'x-' are headers and should be attached to the request in the standard way.

Anatomy of an Upload

All MediaFire Upload APIs conform to the Multipart MIME standard. As such, the file name is specified in the filename field of the Content-Disposition header. An example for such a header can be found below:

POST http://www.mediafire.com/api/unversioned/upload/simple.php?uploadkey=5bb66g94blnnk&session_token=aa22f5a968f827daf69fd6b3515110c43e036bc5d2ed8b81657dd1bdfe4b4c3e3ea6757d1f47bc3d6a001a16bc6f25abb486c5e779328a5769bd9ed6064edb69 HTTP/1.1
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:12.0) Gecko/20100101 Firefox/12.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-us,en;q=0.5
Accept-Encoding: gzip, deflate
x-filehash:564dc5e9541a494e966066da8b2392e2e70e2438e4fcf4b0058cd9249abc4e1d
x-filesize:29278
x-filetype:text/plain
Content-Type: multipart/form-data; boundary=---------------------------41184676334
Content-Length: 29278

-----------------------------41184676334


Summer vacation
-----------------------------41184676334
Content-Disposition: form-data; name="image1"; filename="GrandCanyon.jpg"
Content-Type: image/jpeg

(Binary data not shown)
-----------------------------41184676334--
                        

In the example above, the custom header x-filehash is supplied. While this header is not required for all upload scenarios, its inclusion is strongly recommended as it will ensure a higher level of upload data integrity. Although it is not shown in this example, the custom headers x-filename and x-filesize are also supported. The x-filesize header is required when Content-Type is multipart/form-data or application/octet-stream. The x-filename header is required when Content-Type is application/octet-stream(this is because the filename is not included in the POST body like it is for multipart/form-data).

File Size Information

MediaFire handles uploads slightly differently depending on the file size. This ensures data integrity as much as possible. Using the recommended API method for a given file size will ensure the best user experience.

<= 4MB
This is the lowest division that MediaFire recognizes for file size. Files up to 4MB should have no problem uploading as a single chunk. As such, there is no benefit in calling the upload/resumable API method in this scenario.

> 4MB, <= 20MB
Files between 4MB and 20MB are considered medium size files and, in many user scenarios, shouldn't have a problem uploading as a single chunk. The API upload/resumable is a more complicated method to implement. Therefore, the developer should use their own discretion as to whether upload/resumable is worth implementing.

> 20MB Files greater than 20MB are considered large size files and MediaFire highly recommends that developers utilize upload/resumable for these files as the risk for upload interruption is much greater.

Bitmap Information

APIs upload/resumable and upload/check (for a resumable upload in progress) responses contain a resumable_upload property. A sub-property of resumable_upload is bitmap. The bitmap property holds important information about the state of the resumable upload, specifically, which chunks have successfully uploaded to the cloud.

The client can use the bitmap information to find out which chunks are uploaded and which chunks still need to be uploaded by decoding the bitmap. The client will also need to know how many chunks are in the upload by looking at the number_of_units sub-property of resumable_upload.

The bitmap property contains two sub-properties: count and words. The property count indicates the number of words in the words property. The property words contains a set of integers, each of which represent a 16-bit word.

Each bit of a word represents a specific file chunk. A bit designated as 'on' represents a successfully uploaded file chunk.

The first word in the set represents file chunks 0 to 15. The second word represents file chunks 16 to 31, and so on.

Example: (count=2, words=[1258, 495] and number_of_units=28)

• Convert word one to binary > 0000010011101010.
• Read the result from right to left.
• According to word one, chunks 1, 3, 5, 6, 7 and 10 have uploaded successfully.
• Convert word two to binary > 0000000111101111.
• Read the result from right to left.
• According to word two, chunks 16, 17, 18, 19, 21, 22, 23 and 24 have uploaded successfully.
• File chunks 0, 2, 4, 8, 9, 20, 25, 26, 27 and 28 have not uploaded successfully.

/**
 * Decodes the bitmap returned by the upload/pre_upload api call (response.resumable_upload.bitmap)
 * Returns an array of units, the index being the unit's ID and the value being a boolean indicating whether the unit is uploaded or not
 */
function decodeBitmap(bitmap) {
  var uploadUnits = [];
  for (var i = 0; i < bitmap.count; i++) {
    var word = parseInt(bitmap.words[i], 10);
    var bin = word.toString(2);
    while(bin.length < 16) {
      bin = '0' + bin;
    }
    for (var b = 0; b < bin.length; b++) {
      uploadUnits[i*16 + b] = (bin[15 - b] == '1');
    }
  }
  return uploadUnits;
}
 
// Let's assume the API returned a JSON response which contains a bitmap under (response.resumable_upload.bitmap) and has two words with values 17 and 32.
bitmap = {count: 2, words: [17, 32]};
 
var unitUploaded = decodeBitmap(bitmap);
 
alert(unitUploaded[0]); // true
alert(unitUploaded[3]); // false
alert(unitUploaded[4]); // true
alert(unitUploaded[21]); // true
alert(unitUploaded[22]); // false

Normal Uploads

Via upload/instant

• Provide parameters filename, hash, and size.
• If the response includes hash_exists=yes then the file can be uploaded 'instantly'. Otherwise, a full file upload is necessary via upload/simple or upload/resumable.

• Provide parameters session_token, hash, size and filename.

Via upload/simple

• Provide the binary file data via the POST body.
• Provide header Content-Type.
• Provide parameters session_token or filedrop_key.

Via upload/resumable

• Provide parameters session_token, filename, hash, size, and resumable=yes.

• Provide the binary file data of the chunk being uploaded via the POST body.
• Provide headers x-filesize, x-filehash, x-unit-hash, x-unit-id, and x-unit-size.

Patch Uploads

• Source File: The user's file which will be patched using the patch file.
• Patched File: The source file after the patch file has been applied.
• Patch File: The file used to patch the source file to create the patched file.

Via upload/instant

• Provide parameters filename(of the source file), hash(of the patched file), and size(of the patched file).

• Provide parameters session_token, quick_key(of the source file), hash(of the patched file), and size(of the patched file).

Via upload/patch

• Provide the binary file data of the patch file being uploaded via the POST body.
• Provide header Content-Type.
• Provide parameters quick_key(of the source file), source_hash(of the source file), target_hash(the patched file's hash), and target_size(the patched file's size).

Via upload/resumable

• Provide parameters filename, hash, and size of the patch file to be uploaded as well as resumable=yes.

• Provide the binary file data of the chunk being uploaded via the POST body.
• Provide headers x-filesize, x-filehash, x-unit-hash, x-unit-id, and x-unit-size.
• Provide parameters quick_key(of the source file), source_hash(of the source file), target_hash(the patched file's hash), and target_size(the patched file's size).

Update Uploads

• Source File: The user's file which will be updated using the update file.
• Updated File: The source file after the contents have been replaced with the contents of the update file.
• Update File: The file used to update the source file to create the updated file.

Via upload/instant

• Provide parameters filename(of the source file), hash(of the update file), and size(of the update file).

• Provide parameters session_token, quick_key(of the source file), hash(of the update file), and size(of the update file).

Via upload/update

• Provide the binary file data of the update file being uploaded via the POST body.
• Provide parameters session_token and quick_key(of the source file).

Via upload/simple

• Provide the binary file data of the update file being uploaded via the POST body
• Provide header Content-Type.
• Provide parameters session_token or filedrop_key and action_on_duplicate=replace.

Via upload/resumable

• Provide parameters filename, hash, and size of the update file to be uploaded as well as resumable=yes.

• Provide the binary file data of the chunk being uploaded via the POST body.
• Provide headers x-filesize, x-filehash, x-unit-hash, x-unit-id, and x-unit-size.
• Provide parameters quick_key(of the source file), source_hash(of the source file), target_hash(the updated file's hash), and target_size(the updated file's size).

Web Uploads

Via upload/add_web_upload

• Provide parameters session_token, url, and filename.

Add Web Upload

Notes: New parameter quick_key.

Description : Adds a new web upload and returns the Upload Key on success.

Required Parameters:

• session_token : A type 1 or type 2 session token. (Type 2 will require a call signature) Alternatively, you may use an action token in place of a session token.
• url : The URL of the file you wish to be placed into your MediaFire account.
• filename : The UTF-8 encoded name, plus extension, of the file to be created(3 to 255 characters in length).

Relative Parameters:

• signature : Required only for session token version 2. Click here to learn more about building an API call signature.

Optional Parameters:

• quick_key : The file key of a preexisting file in the session user's account. This file will be updated with the content of the uploaded file.
• folder_key : The key that identifies the destination folder. If not passed, then it will return the root folder (session token is then required). Alternatively, you may pass myfiles as a folderkey moniker for the root folder.
• response_format : 'xml' or 'json' (default 'xml')

Response Properties

Error Codes

Examples:

HTTPS://www.mediafire.com/api/upload/add_web_upload.php?session_token=&url=http://static.befunky.com/V4/images/BeFunkyLogo_onBlack_v1.png&filename=funky.png&response_format=json&signature=

{
   action: upload/add_web_upload,
   upload_key: aogvo25zua,
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
}

HTTPS://www.mediafire.com/api/1.4/upload/add_web_upload.php?session_token=&url=http%3A%2F%2Fwww.screendaily.com%2Fpictures%2F636xAny%2F9%2F9%2F5%2F1176995_Rigor-Mortis.jpg&filename=rig2.jpg&quick_key=g7vpy8xves57blv&response_format=xml&signature=

<action>upload/add_web_upload</action>
<upload_key>xa43h46zmh</upload_key>
<result>Success</result>
<new_key>yes</new_key>
<current_api_version>1.4</current_api_version>

Check

Notes: New parameter preemptive.
New parameter device_id.
New parameter uploads.

Description: Checks if a duplicate filename exists in the destination folder and verifies folder permissions for non-owner uploads. When a hash is supplied, hash_exists is returned to indicate whether an instant upload is possible. Several flags are returned, which can be "yes" or "no": file_exists (with the same name and location), different_hash (if file_exists), hash_exists (somewhere in the cloud), in_account (if hash_exists), and in_folder (if hash_exists). If a path is supplied, a folder_key will also be returned to be used for a subsequent upload. If resumable is supplied as "yes", a resumable upload will be initiated, and resumable_upload will be returned containing the relevant data.

Required Parameters:

• filename : The UTF-8 encoded name, plus extension, of the file to be created(3 to 255 characters in length). Filename is not required if both hash and size are passed.

Relative Parameters:

• session_token : A type 1 or type 2 session token. (Type 2 will require a call signature) Alternatively, you may use an action token in place of a session token.
• signature : Required only for session token version 2. Click here to learn more about building an API call signature.
• size : The size, in bytes, of the file being uploaded. Required if hash is passed or resumable=yes.
• uploads : A JSON formatted array of parameters for batch requests(see Batching below). Required if filename is not passed. Takes precedence over other parameters.
• device_id : The ID of the calling device. Required if preemptive=yes. Cannot be 0(cloud). 255 reserved for unpaired devices.
• hash : The SHA256 hash of the file being uploaded. If not passed, no content checks can be made. Required if resumable=yes or preemptive=yes.
• filedrop_key : The destination filedrop folder key. Required if session_token is not passed. Ignored if session_token or folder_key is passed.

Optional Parameters:

• folder_key : The destination folder key. If not passed, device 0's(cloud) root is used. myfiles may be passed as a moniker for device 0's(cloud) root.
• path : The destination absolute or relative path. Absolute paths begin with a slash; relative paths do not and are in relation to the specified folder_key or filedrop_key. Non-existent folders will not be created by this call.
• resumable : Specifies whether to make this upload resumable or not. no(default) or yes.
• preemptive : Specifies whether to generate a preemptive quickkey or not for use in a future upload. Preemptive keys are not created when an instant upload is available. no(default) or yes.
• response_format : 'xml' or 'json' (default 'xml')

[
   {
      "filename":"Microsoft-Windows-Common-Modem-Drivers-Package~31bf3856ad364e35~amd64~~6.1.7601.17514.mum",
      "hash":"5a6228aecc1eea6c3463f3fba1c3cdaca4b7b4d7c3d583c9955ebe7558fc298d",
      "size":"64690"
   },
   {
      "filename":"Win8IP-Microsoft-Windows-Multimedia-Package~31bf3856ad364e35~amd64~bg-BG~7.1.7601.16492.cat",
      "hash":"3ee9258151c834bba9d499dea3026122a10432e3dfe3a5d989d68978a85e3237",
      "size":"8718"
   }
]

Response Properties

Error Codes

Examples:

HTTPS://www.mediafire.com/api/1.4/upload/check.php?session_token=&filename=s20.png&hash=264fe239a7dd06374061a1d67cb6aa66946dd7b08a822f4b184c00b80a64a3a4&size=457490&response_format=json&signature=

{
   action: upload/check,
   hash_exists: yes,
   in_account: no,
   in_folder: no,
   file_exists: no,
   available_space: 1084160580684,
   used_storage_size: 318661556,
   storage_limit: 1084479242240,
   storage_limit_exceeded: no,
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
}

HTTPS://www.mediafire.com/api/1.4/upload/check.php?session_token=&filename=s20.png&hash=264fe239a7dd06374061a1d67cb6aa66946dd7b08a822f4b184c00b80a64a3a4&size=457490&path=Test%20002&response_format=xml&signature=

<action>upload/check</action>
<hash_exists>yes</hash_exists>
<in_account>no</in_account>
<in_folder>no</in_folder>
<file_exists>no</file_exists>
<available_space>1084160580684</available_space>
<used_storage_size>318661556</used_storage_size>
<storage_limit>1084479242240</storage_limit>
<storage_limit_exceeded>no</storage_limit_exceeded>
<folder_key>b5brfb1s16fr0</folder_key>
<result>Success</result>
<new_key>yes</new_key>
<current_api_version>1.4</current_api_version>

Example 3 (Success with JSON - beginning a resumable upload):

HTTPS://www.mediafire.com/api/1.4/upload/check.php?session_token=&filename=My%20Movie%20001.mp4&hash=97e3663622edc92d7b4beb3662e48e1c74cc00dfc69cf96f4d3eabf44f94dd1e&size=8608803&resumable=yes&response_format=json&signature=
                        

{
   action: upload/check,
   hash_exists: yes,
   in_account: yes,
   in_folder: yes,
   file_exists: yes,
   different_hash: no,
   duplicate_quickkey: x8lc3su0u8z6m17,
   resumable_upload:{
      all_units_ready: no,
      number_of_units: 9,
      unit_size: 1048576,
      bitmap:{
         count: 1,
         words:[
            0,
         ]
      }
   }
   available_space: 1084160580684,
   used_storage_size: 318661556,
   storage_limit: 1084479242240,
   storage_limit_exceeded: no,
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
}

Example 4 (Success with JSON - returning upload_key for an in-progress or recently finished resumable upload):

HTTPS://www.mediafire.com/api/1.4/upload/check.php?session_token=&filename=My%20Movie%20001.mp4&hash=97e3663622edc92d7b4beb3662e48e1c74cc00dfc69cf96f4d3eabf44f94dd1e&size=8608803&resumable=yes&response_format=xml&signature=

<action>upload/check</action>
<hash_exists>yes</hash_exists>
<in_account>yes</in_account>
<in_folder>yes</in_folder>
<file_exists>yes</file_exists>
<different_hash>no</different_hash>
<duplicate_quickkey>x8lc3su0u8z6m17</duplicate_quickkey>
<resumable_upload>
   <all_units_ready>no</all_units_ready>
   <number_of_units>9</number_of_units>
   <unit_size>1048576</unit_size>
   <bitmap>
      <count>1</count>
      <words>
         <word>1</word>
      </words>
   </bitmap>
   <upload_key>yczao20rkf2</upload_key>
</resumable_upload>
<available_space>1084160580684</available_space>
<used_storage_size>318661556</used_storage_size>
<storage_limit>1084479242240</storage_limit>
<storage_limit_exceeded>no</storage_limit_exceeded>
<result>Success</result>
<new_key>yes</new_key>
<current_api_version>1.4</current_api_version>

Example 5 (Success with JSON - Returning a preemptive key):

HTTPS://www.mediafire.com/api/1.4/upload/check.php?session_token=&filename=i002.png&hash=a86a7e6a71dbe8d84feb9b743a25d4d4bca2242e1c7e84346efb65ae722b84e4&size=181030&device_id=2&resumable=no&preemptive=yes&response_format=json&signature=
                        

{
   action: upload/check,
   hash_exists: no,
   file_exists: no,
   preemptive:{
      quickkey: b7hbdkoyqi6ct7g,
   }
   available_space: 1084160580684,
   used_storage_size: 318661556,
   storage_limit: 1084479242240,
   storage_limit_exceeded: no,
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
}

HTTPS://www.mediafire.com/api/1.4/upload/check.php?session_token=&uploads=%5B%7B%22filename%22%3A%22Microsoft-Windows-Common-Modem-Drivers-Package~31bf3856ad364e35~amd64~~6.1.7601.17514.mum%22%2C%22hash%22%3A%225a6228aecc1eea6c3463f3fba1c3cdaca4b7b4d7c3d583c9955ebe7558fc298d%22%2C%22size%22%3A%2264690%22%7D%2C%7B%22filename%22%3A%22Win8IP-Microsoft-Windows-Multimedia-Package~31bf3856ad364e35~amd64~bg-BG~7.1.7601.16492.cat%22%2C%22hash%22%3A%223ee9258151c834bba9d499dea3026122a10432e3dfe3a5d989d68978a85e3237%22%2C%22size%22%3A%228718%22%7D%5D&response_format=json&signature=
                        

{
   action: upload/check,
   upload_checks:[
      {
         filename: Microsoft-Windows-Common-Modem-Drivers-Package~31bf3856ad364e35~amd64~~6.1.7601.17514.mum,
         hash_exists: yes,
         in_account: no,
         in_folder: no,
         file_exists: no,
         available_space: 1084160580684,
         used_storage_size: 318661556,
         storage_limit: 1084479242240,
         storage_limit_exceeded: no,
      }
      {
         filename: Win8IP-Microsoft-Windows-Multimedia-Package~31bf3856ad364e35~amd64~bg-BG~7.1.7601.16492.cat,
         hash_exists: yes,
         in_account: no,
         in_folder: no,
         file_exists: no,
         available_space: 1084160580684,
         used_storage_size: 318661556,
         storage_limit: 1084479242240,
         storage_limit_exceeded: no,
      }
   ]
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
}

HTTPS://www.mediafire.com/api/upload/check.php?session_token=&filename=error395.png&hash=&size=32392&folder_key=ll19p52lfxqoe&resumable=no&response_format=xml&signature=
                        

<action>upload/check</action>
<message>Access denied</message>
<error>114</error>
<result>Error</result>
<new_key>yes</new_key>
<current_api_version>1.4</current_api_version>

Get Options

Description: Get upload preferences. Preferences include the following data: disable_flash, disable_html5, disable_instant, & action_on_duplicate.

Required Parameters:

• session_token : A type 1 or type 2 session token. (Type 2 will require a call signature) Alternatively, you may use an action token in place of a session token.

Relative Parameters:

• signature : Required only for session token version 2. Click here to learn more about building an API call signature.

Optional Parameters:

• response_format : 'xml' or 'json' (default 'xml')

Response Properties

Error Codes

Examples:

HTTPS://www.mediafire.com/api/upload/get_options.php?session_token=&response_format=json&signature=

{
   action: upload/get_options,
   disable_flash: no,
   disable_html5: no,
   disable_instant: yes,
   action_on_duplicate: replace,
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
} 

Get Web Uploads

Description: Returns a list of queued, in progress, and finished web uploads along with their associated information.

Required Parameters:

• session_token : A type 1 or type 2 session token. (Type 2 will require a call signature) Alternatively, you may use an action token in place of a session token.

Relative Parameters:

• signature : Required only for session token version 2. Click here to learn more about building an API call signature.

Optional Parameters:

• all_web_uploads : Specifies whether to return all web uploads(queued, active and completed). Includes all available file information for the uploads. If no, only active uploads, status 2 through 4, will be returned. no(default) or yes.
• upload_key : Filter results by an upload key obtained from upload/add_web_upload. If the specified upload is completed, it will only be returned if all_web_uploads=yes.
• response_format : 'xml' or 'json' (default 'xml')

Response Properties

Error Codes

Examples:

HTTPS://www.mediafire.com/api/upload/get_web_uploads.php?session_token=&response_format=json&signature=
                        

{
   action: upload/get_web_uploads,
   web_uploads:[
      {
         uploadkey: 93do9m68rx,
         active: yes,
         quickkey: ,
         filename: 007.zip,
         created: 2015-02-16 17:30:40,
         status_code: 3,
         status: Transfer is in progress,
         error_status: 0,
         url: http://download.thinkbroadband.com/20MB.zip,
         eta: 4 seconds,
         size: 20971520,
         percentage: 84,
      }
   ]
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
}
                        

Example 2 (Success with XML - all_web_uploads=yes):

HTTPS://www.mediafire.com/api/upload/get_web_uploads.php?session_token=&all_web_uploads=yes&response_format=xml&signature=

<action>upload/get_web_uploads</action>
<web_uploads>
   <web_upload>
      <uploadkey>93do9m68rx</uploadkey>
      <active>no</active>
      <quickkey>qjffa4pk82zydy3</quickkey>
      <filename>007.zip</filename>
      <created>2015-02-16 17:30:40</created>
      <status_code>99</status_code>
      <status>Transfer complete</status>
      <error_status>0</error_status>
      <url>http://download.thinkbroadband.com/20MB.zip</url>
      <eta>Transfer completed</eta>
      <size>20971520</size>
      <percentage>100</percentage>
   </web_upload>
   <web_upload>
      <uploadkey>3gp4nwrt83</uploadkey>
      <active>no</active>
      <quickkey>52v2pmig8q0uv47</quickkey>
      <filename>006.jpg</filename>
      <created>2015-02-16 17:19:18</created>
      <status_code>99</status_code>
      <status>Transfer complete</status>
      <error_status>0</error_status>
      <url>http://upload.wikimedia.org/wikipedia/commons/6/66/Big_size_chess_6759_CRI_08_2009_Langosta_Beach.jpg</url>
      <eta>Transfer completed</eta>
      <size>1094574</size>
      <percentage>100</percentage>
   </web_upload>
   <web_upload>
      <uploadkey>o1ld6w6ga1</uploadkey>
      <active>no</active>
      <quickkey></quickkey>
      <filename>002.jpg</filename>
      <created>2015-02-16 17:13:21</created>
      <status_code>1</status_code>
      <status>Waiting to start</status>
      <error_status>0</error_status>
      <url>http://snackface.files.wordpress.com/2009/06/huge.jpg</url>
      <eta>n/a</eta>
      <size>0</size>
      <percentage>1</percentage>
   </web_upload>
</web_uploads>
<result>Success</result>
<new_key>yes</new_key>
<current_api_version>1.4</current_api_version>

Example 3 (Success with JSON - all_web_uploads=yes filtering by upload_key):

HTTPS://www.mediafire.com/api/upload/get_web_uploads.php?session_token=&all_web_uploads=yes&upload_key=2xpae4meae&response_format=json&signature=

{
   action: upload/get_web_uploads,
   web_uploads:[
      {
         uploadkey: 2xpae4meae,
         active: yes,
         quickkey: ,
         filename: 008.zip,
         created: 2015-02-16 17:38:06,
         status_code: 2,
         status: Webupload is starting,
         error_status: 0,
         url: http://download.thinkbroadband.com/200MB.zip,
         eta: n/a,
         size: 0,
         percentage: 1,
      }
   ]
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
}

Instant

Description: If the file already exists in the cloud, by hash and size match, copy the file into the session user's account instead of re-uploading it. Returns a quickkey on successful instant upload.

Required Parameters:

• size : File size in bytes. This needs to be passed if hash is passed. Required if resumable="yes".
• hash : SHA-256 hash of the file. If not passed, no content checks can be made. Required if resumable="yes". Hash is not case sensitive.

Relative Parameters:

• session_token : A type 1 or type 2 session token. (Type 2 will require a call signature) Alternatively, you may use an action token in place of a session token. Required only if filedrop_key or folder_key are not passed.
• filename : The UTF-8 encoded name, plus extension, of the file to be created(3 to 255 characters in length). Required if quickkey is not passed.
• filedrop_key : The destination filedrop folder key. Required if session_token is not passed. Ignored if session_token and folder_key is passed.
• signature : Required only for session token version 2. Click here to learn more about building an API call signature.

Optional Parameters:

• quick_key : To update an existing file, pass its quickkey.
• folder_key: The destination folder to store the file. If it's not passed, then the file will be stored in the root folder. Alternatively, you may pass myfiles as a folderkey moniker for the root folder.
• path : An absolute or relative path to upload the file to. Absolute paths begin with a slash; relative paths do not and are in relation to the specified folder_key or filedrop_key. Non-existent folders will not be created by this call.
• action_on_duplicate : When a file with the same name is encountered in the same folder, this determines how the conflict is resolved. Possible values are "skip" to ignore the upload (default), "keep" to keep both files with a new one with a number appended, and "replace" to overwrite the old file adding to its version history.
• mtime : Date-time used as the creation time of the file. If not passed the current server time is used. Refer to the following document for valid date/time formats: http://www.php.net/manual/en/datetime.formats.php
• version_control : Specifies if file versions are made and, if so, what type. Ignored if quickkey is not passed or action_on_duplicate is not replace.create_patches(creates a patch to the old file version)(default), keep_revision(keeps the old file version as a full file), none(the old file version is not kept).
• previous_hash : The hash of the last known version of the file before it was modified. Ignored if quickkey is not passed or action_on_duplicate is not replace. If previous_hash does not match device 0's(cloud) file's hash the file will be uploaded as a new file with a new quickkey and file name.
• response_format : 'xml' or 'json' (default 'xml')

Response Properties

Error Codes

Examples:

Example 1 (Success with JSON):

HTTPS://www.mediafire.com/api/1.4/upload/instant.php?session_token=&hash=&size=2986&filename=t1.png&version_control=none&response_format=json&signature=
                        

{
   action: upload/instant,
   quickkey: adz62va71ryktm8,
   filename: t1.png,
   newrevision:{
      revision: 28.1,
      epoch: 1430324685,
   }
   newfolderrevision:{
      revision: 45,
      epoch: 1430348561,
   }
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
   new_device_revision: 161699,
}                        

Example 2 (Success with XML - updating preexisting file):

HTTPS://www.mediafire.com/api/1.4/upload/instant.php?session_token=&hash=&size=553&filename=t2.png&quick_key=adz62va71ryktm8&version_control=none&previous_hash=&response_format=xml&signature=
                        

<response>
  <action>upload/instant</action>
  <quickkey>32d392v90o3pvd3</quickkey>
  <filename>whatever.gif</filename>
  <newrevision>
    <revision>456222</revision>
  </newrevision>
  <newfolderrevision>
    <revision>123</revision>
  </newfolderrevision>
  <result>Success</result>
  <new_device_revision>22554</new_device_revision>
  <current_api_version>1.4</current_api_version>
</response>                        

Patch

Note: This API currently returns a Content-Type=text/xml header even when the response is in JSON format.

Description: Patch uploads are uploads of patch(diff) files created via the algorithm used by xdelta 3 and VCDIFF/RDC3284. The system uses the patch file to update the contents of a file already existing in the user's account. This method is useful when client software retains a local copy of the user's file. If the user updates the file locally, the client sync process needs to only upload the patch file to update the cloud copy of the file. This method saves time and bandwidth over a full file upload.

Required Parameters:

• session_token : A type 1 or type 2 session token. (Type 2 will require a call signature) Alternatively, you may use an action token in place of a session token.
• quick_key : The file key of a preexisting file in the session user's account. This file will be updated utilizing the uploaded patch file.
• source_hash : The MD5 or SHA256 hash of the file to be patched as reported from file/get_info. Hash is not case sensitive.
• target_hash : The expected SHA256 hash of the target file. A SHA256 check-sum of the target file. Hash is not case sensitive.
• target_size : The expected size, in bytes, of the target file.

• Content-Type : Either "application/octet-stream" or "multipart/form-data + boundary".

Relative Parameters:

• signature : Required only for session token version 2. Click here to learn more about building an API call signature.

• x-filename : The UTF-8 encoded name, plus extension, of the file to be created(3 to 255 characters in length). Required and only used for Content-Type: "application/octet-stream".
• x-filesize : The size, in bytes, of the patch file being uploaded. Required and only used for Content-Type: "application/octet-stream".

Optional Parameters:

• mtime : The date/time of the update. If not set, the current server time will be used. Refer to the following document for valid date/time formats: http://www.php.net/manual/en/datetime.formats.php
• version_control : Specifies if file versions are made and, if so, what type. Ignored if quickkey is not passed or action_on_duplicate is not replace.create_patches(creates a patch to the old file version)(default), keep_revision(keeps the old file version as a full file), none(the old file version is not kept).
• response_format : xml(default) or json.

Response Properties

Error Codes

Examples:

HTTPS://www.mediafire.com/api/1.4/upload/patch.php?session_token=&quick_key=4znq80iev8p5n38&source_hash=&target_hash=&target_size=35&version_control=none&response_format=json&signature=

{
   action: upload/patch,
   doupload:{
      result: 0,
      key: mp2inhei2x6,
   }
   server: live,
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
}
                        

Poll Upload

Notes: Functionality changed for parameter key.

Description: Check for the status of a current Upload. This can be called after using any of the upload family of APIs which return an upload key. Use the key returned (response.doupload.key) to request the status of the current upload. Keep calling this API every few seconds until you get the status value 99 which means that the upload is complete. The quickkey of the file and other related information is also returned when the upload is complete.

Required Parameters:

• key : A comma-separated list of upload keys obtained in the responses from upload/patch, upload/resumable, upload/simple, upload/update. The maximum number of upload keys allowed is 100.

Relative Parameters:

• none

Optional Parameters:

• response_format : 'xml' or 'json' (default 'xml')

Response Properties

Examples:

HTTPS://www.mediafire.com/api/1.4/upload/poll_upload.php?key=7kpt994gnu2&response_format=xml

<action>upload/poll_upload</action>
<doupload>
   <result>0</result>
   <status>99</status>
   <description>No more requests for this key</description>
   <fileerror></fileerror>
   <quickkey>l5dbj2ejhefal2g</quickkey>
   <hash>e02823f0ec85be2c364a27dba7485501aaf26455135c4afb9b50f3cea52733ca</hash>
   <filename>avatar(2).png</filename>
   <size>7763</size>
   <created>2015-03-25 16:13:43</created>
   <revision>162900</revision>
   <resumable_upload></resumable_upload>
   <created_utc>2015-03-25T21:13:43Z</created_utc>
</doupload>
<result>Success</result>
<current_api_version>1.4</current_api_version>
                        

HTTPS://www.mediafire.com/api/1.4/upload/poll_upload.php?key=7kpt994gnu2%2Cyczao20rkf2&response_format=json

{
   action: upload/poll_upload,
   douploads:[
      {
         key: 7kpt994gnu2,
         result: 0,
         status: 99,
         description: No more requests for this key,
         fileerror: ,
         quickkey: l5dbj2ejhefal2g,
         hash: e02823f0ec85be2c364a27dba7485501aaf26455135c4afb9b50f3cea52733ca,
         filename: avatar(2).png,
         size: 7763,
         created: 2015-03-25 16:13:43,
         revision: 162900,
         resumable_upload: ,
         created_utc: 2015-03-25T21:13:43Z,
      }
      {
         key: yczao20rkf2,
         result: 0,
         status: 17,
         description: Upload is in progress,
         fileerror: ,
         quickkey: ,
         hash: ,
         filename: ,
         size: ,
         created: ,
         revision: ,
         resumable_upload:{
            all_units_ready: no,
            number_of_units: 9,
            unit_size: 1048576,
            bitmap:{
               count: 1,
               words:[
                  3,
               ]
            }
         }
      }
   ]
   result: Success,
   current_api_version: 1.4,
}
                        

Resumable

Note: This API currently returns a Content-Type=text/xml header even when the response is in JSON format.

Description: Uploading large files through upload/simple can take a long time. Additionally, if it fails, re-uploading the file starts from the beginning. With a resumable upload you can upload the file in small units or chunks. Therefore, if one unit fails to upload, only that unit is re-uploaded. upload/resumable can only be called after a call to upload/check which will then initiate the resumable upload. This API returns the upload key when successful. After you upload all the units, you can pass the key to upload/poll_upload to get the quickkey. Please refer to the documentation about the API upload/poll_upload for more details.

Required Parameters:

• The content(binary data) of the file to upload.

• x-filesize : The size, in bytes, of the binary file data.
• x-filehash : A SHA256 hash of the file. Hash is not case sensitive.
• x-unit-hash : A SHA256 hash of the unit being uploaded. Hash is not case sensitive.
• x-unit-id : An ID of the unit. Can be 0 through Number of units - 1
• x-unit-size : The size of the unit being uploaded.
• Content-Type : Either "application/octet-stream" or "multipart/form-data + boundary".

Relative Parameters:

session_token : A session access token to authenticate the user's current session. Required if filedrop_key or folder_key is not passed. Alternatively, a valid action token may be used instead.
• filedrop_key : A key representing a filedrop folder. Required if session_token is not passed. Ignored if folder_key is passed.
• source_hash : The hash of the target file to be patched. Required if quickkey is passed. Hash is not case sensitive.
• target_hash : The expected hash of the target file after it is patched. A SHA256 check-sum of the target file. Required if quickkey is passed. Hash is not case sensitive.
• target_size : The expected size of the target file after is is patched. Required if quickkey is passed. Hash is not case sensitive.
• signature : Required only for session token version 2. Click here to learn more about building an API call signature.

• x-filename : The UTF-8 encoded name, plus extension, of the file to be created(3 to 255 characters in length). Required and only used for Content-Type: "application/octet-stream".

Optional Parameters:

• quick_key : The file key of a file already in the session user's account. This file will be updated with the content of the uploaded file.
• folder_key : The destination folder key. If not passed the API will use the cloud root folder. Alternatively, you may pass myfiles as a folderkey moniker for the root folder.
• path : An absolute or relative path to upload the file to. Absolute paths begin with a slash; relative paths do not and are in relation to the specified folder_key or filedrop_key. Non-existent folders will be created by this call.
• action_on_duplicate : Specifies the action to take when the file already exists, by name, in the destination folder. skip ignores the upload, keep uploads the file and makes the file name unique by appending a number to it, and replace overwrites the old file, possibly adding to its version history. skip (default), keep, replace.
• mtime : Date-time used as the creation time of the file. If not passed the current server time is used. Click here for valid date/time formats.
• version_control : Specifies if file versions are made and, if so, what type. If quickkey is not passed or action_on_duplicate is not replace this parameter is ignored. create_patches creates the new version and maintains patches to the updated version, keep_revision creates the new version and maintains the updated version as a full file, none creates the new version and maintains no patches or full files of the updated version. create_patches(default), keep_revision, none.
• previous_hash : The hash of the last known version of the file before it was modified. If quickkey is not passed or action_on_duplicate is not replace this parameter is ignored. If previous_hash does not match the cloud file's hash the file will be uploaded as a new file with a new quickkey and file name. Hash is not case sensitive.
• response_format : xml(default) or json.

Response Properties

Error Codes

Examples:

HTTPS://www.mediafire.com/api/upload/resumable.php?session_token=&version_control=none&response_format=xml&signature=
                        

<action>upload/resumable</action>
<doupload>
   <result>0</result>
   <key>8t2ln2yh33m</key>
</doupload>
<server>live</server>
<resumable_upload>
   <all_units_ready>no</all_units_ready>
   <number_of_units>9</number_of_units>
   <unit_size>1048576</unit_size>
   <bitmap>
      <count>1</count>
      <words>
         <word>1</word>
      </words>
   </bitmap>
</resumable_upload>
<result>Success</result>
<new_key>yes</new_key>
<current_api_version>1.4</current_api_version>
                        

HTTPS://www.mediafire.com/api/upload/resumable.php?session_token=&source_hash=&target_hash=&target_size=79&quick_key=v6zhd7ocuo92sl7&version_control=none&response_format=json&signature=
                        

{
   action: upload/resumable,
   doupload:{
      result: 0,
      key: a29d0al9lie,
   }
   server: live,
   resumable_upload:{
      all_units_ready: yes,
      number_of_units: 1,
      unit_size: 4194304,
      bitmap:{
         count: 1,
         words:[
            1,
         ]
      }
   }
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
}
                        

HTTPS://www.mediafire.com/api/upload/resumable.php?session_token=&quick_key=ridrad9hrx86219&version_control=keep_revision&previous_hash=&response_format=json&signature=
                        

<action>upload/resumable</action>
<doupload>
   <result>0</result>
   <key>zf07g05vbgs</key>
</doupload>
<server>live</server>
<resumable_upload>
   <all_units_ready>yes</all_units_ready>
   <number_of_units>1</number_of_units>
   <unit_size>4194304</unit_size>
   <bitmap>
      <count>1</count>
      <words>
         <word>1</word>
      </words>
   </bitmap>
</resumable_upload>
<result>Success</result>
<new_key>yes</new_key>
<current_api_version>1.4</current_api_version>
                        

Set Options

Description: This API will set the user's preferences for uploads when using the JavaScript Upload client on the MediaFire website.

Required Parameters:

• session_token : A type 1 or type 2 session token. (Type 2 will require a call signature) Alternatively, you may use an action token in place of a session token.

Relative Parameters:

• signature : Required only for session token version 2. Click here to learn more about building an API call signature.

Optional Parameters:

• disable_flash : To disable Flash uploads 'yes' or 'no'.
• disable_html5 : To disable HTML5 uploads 'yes' or 'no'.
• disable_instant : To disable instant uploads. Instant uploads works only when HTML5 uploads are enabled. 'yes' or 'no'.
• action_on_duplicate : Specifies the action to take when the file already exists, by name, in the destination folder. skip ignores the upload, keep uploads the file and makes the file name unique by appending a number to it, and replace overwrites the old file, possibly adding to its version history. skip(default), keep, replace.
• response_format : 'xml' or 'json' (default 'xml')

Response Properties

Error Codes

Examples:

http://www.mediafire.com/api/upload/set_options.php?disable_flash=yes&disable_instant=yes&session_token=01d8d27a6135e97bbda5a08bf37caf10be09e64acef0f60e56085bc96a22337e5f199d7a71cf0c6ee132003b7592a5dce45b73e3f79e915769e27c6ea3636cc1&hash=65dd21d705d5680cf7777286d627de9e799ef03e2ff0374df297382e3f1cd1d1&response_format=json
                        

{
  "response": {
    "action": "upload/set_options",
    "result": "Success",
    "current_api_version": "1.4"
  }
}
                        

Simple

Note: This API currently returns a Content-Type=text/xml header even when the response is in JSON format.

Description: Upload a new file through POST to the user's account. You can either use the session token to authenticate the user, or pass the FileDrop folder key. This API returns the upload key when successful. You will have to pass this key to upload/poll_upload to get the quickkey. Please refer to the documentation about the API upload/poll_upload for more details.

Required Parameters:

• The content(binary data) of the file to upload.

• Content-Type : Either "application/octet-stream" or "multipart/form-data + boundary".

Relative Parameters:

• session_token : A type 1 or type 2 session token. (Type 2 will require a call signature) Alternatively, you may use an action token in place of a session token.
• filedrop_key : A key representing a filedrop folder. Required if session_token is not passed. Ignored if folder_key is passed.
• signature : Required only for session token version 2. Click here to learn more about building an API call signature.

• x-filename : The UTF-8 encoded name, plus extension, of the file to be created(3 to 255 characters in length). Required and only used for Content-Type: "application/octet-stream".
• x-filesize : The size, in bytes, of the binary file data. Required and only used for Content-Type: "application/octet-stream".

Optional Parameters:

• folder_key: The destination folder to store the file. If it's not passed, then the file will be stored in the root folder. Alternatively, you may pass myfiles as a folderkey moniker for the root folder.
• path : An absolute or relative path to upload the file to. Absolute paths begin with a slash; relative paths do not and are in relation to the specified folder_key or filedrop_key. Non-existent folders will not be created by this call.
• action_on_duplicate : Specifies the action to take when the file already exists, by name, in the destination folder. skip ignores the upload, keep uploads the file and makes the file name unique by appending a number to it, and replace overwrites the old file, possibly adding to its version history. The default is to use the user's preference set through upload/set_options. If the user has not set a default then skip is used. skip (default), keep, replace.
• mtime : The date/time of the update. If not set, the current server time will be used. Refer to the following document for valid date/time formats: http://www.php.net/manual/en/datetime.formats.php
• response_format : xml(default) or json.

• x-filehash : The SHA256 hash of the file being uploaded. Used to ensure data integrity. Hash is not case sensitive.

Response Properties

Error Codes

Examples:

HTTPS://www.mediafire.com/api/upload/simple.php?session_token=&filedrop_key=&response_format=xml&signature=

<action>upload/simple</action>
<doupload>
   <result>0</result>
   <key>617cbd5e21829a53e133cd3bb1ad5d80</key>
</doupload>
<server>live</server>
<result>Success</result>
<new_key>yes</new_key>
<current_api_version>1.4</current_api_version>

HTTPS://www.mediafire.com/api/upload/simple.php?session_token=&folder_key=8qkxzxu31sqe5&action_on_duplicate=keep&response_format=json&signature=

{
   action: upload/simple,
   doupload:{
      result: 0,
      key: 068n326bzaw,
   }
   server: live,
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
}

HTTPS://www.mediafire.com/api/upload/simple.php?session_token=&path=Folder003&action_on_duplicate=keep&response_format=json&signature=

{
   action: upload/simple,
   doupload:{
      result: 0,
      key: 9h4c4cj9ebz,
   }
   server: live,
   device_revision: 160022,
   result: Success,
   new_key: yes,
   current_api_version: 1.4,
}

Update

Note: This API currently returns a Content-Type=text/xml header even when the response is in JSON format.

Description: Update an existing file in the user's account with another file. This API returns the upload key when successful. You will have to pass this key to upload/poll_upload.php to check the final result of the update upload. Please refer to the documentation about the API upload/poll_upload for more details.

Required Parameters:

• The content(binary data) of the file to upload.

• session_token : A type 1 or type 2 session token. (Type 2 will require a call signature). Required if not uploading to a FileDrop. Alternatively, a valid action token may be used instead.
• quick_key : The quickkey of the file to update. The uploaded file content will be used to patch then override an existing file's current revision defined by the passed quickkey

Relative Parameters:

• signature : Required only for session token version 2. Click here to learn more about building an API call signature.

Optional Parameters:

• mtime : The date/time of the update. If not set, the current server time will be used. Refer to the following document for valid date/time formats: http://www.php.net/manual/en/datetime.formats.php
• previous_hash : The hash of the last known version of the file before it was modified. If previous_hash does not match the cloud file's hash the file will be uploaded as a new file with a new quickkey and file name. Hash is not case sensitive.
• response_format : xml(default) or json.

Response Properties

Error Codes

Examples:

HTTPS://www.mediafire.com/api/upload/update.php?session_token=&quickkey=4o1bd379kbc1bg2&previous_hash=&response_format=xml&signature=

<action>upload/update</action>
<doupload>
   <result>0</result>
   <key>6dbpphc11z2</key>
</doupload>
<server>live</server>
<result>Success</result>
<new_key>yes</new_key>
<current_api_version>1.4</current_api_version>