System1.2
Get Editable Media
GET
http://www.mediafire.com/api/1.2/system/get_editable_media.php
POST
http://www.mediafire.com/api/1.2/system/get_editable_media.php
Description : Returns a list of all supported documents for editing.
Required Parameters:
- none
Relative Parameters:
- none
Optional Parameters:
- group_by_filetype : Groups lists by filetype 'yes' or 'no' (default 'no').
- response_format : 'xml' or 'json' (default 'xml')
Response Properties
| Name | Description | Type |
|---|---|---|
| extensions | The types of files which can be edited on MediaFire. | list of strings |
| result | Indicates if the API call was successful. 'Error' or "Success' | string |
| current_api_version | The latest stable API version number | string |
Error Codes
To view a list of possible error codes for this API, and their descriptions, click here.
Examples:
Example 1 (group_by_filetype = 'no' XML response)
Request
http://www.mediafire.com/api/1.2/system/get_editable_media.php
Response:
<response>
<action>system/get_editable_media</action>
<editable>
<extensions>
<extension>doc</extension>
<extension>docx</extension>
<extension>rtf</extension>
<extension>odt</extension>
<extension>sxw</extension>
<extension>html</extension>
<extension>txt</extension>
<extension>xls</extension>
<extension>xlsx</extension>
<extension>sxc</extension>
<extension>ods</extension>
<extension>csv</extension>
<extension>tsv</extension>
<extension>ppt</extension>
<extension>pps</extension>
<extension>odp</extension>
<extension>sxi</extension>
</extensions>
</editable>
<result>Success</result>
<current_api_version>1.2</current_api_version>
</response>
Example 2 (group_by_file is set to 'yes' XML response):
Request
http://www.mediafire.com/api/1.2/system/get_editable_media.php?group_by_filetype=yes
Response:
<response>
<action>system/get_editable_media</action>
<editable>
<document>
<extensions>
<extension>doc</extension>
<extension>docx</extension>
<extension>rtf</extension>
<extension>odt</extension>
<extension>sxw</extension>
<extension>html</extension>
<extension>txt</extension>
</extensions>
</document>
<spreadsheet>
<extensions>
<extension>xls</extension>
<extension>xlsx</extension>
<extension>sxc</extension>
<extension>ods</extension>
<extension>csv</extension>
<extension>tsv</extension>
</extensions>
</spreadsheet>
<presentation>
<extensions>
<extension>ppt</extension>
<extension>pps</extension>
<extension>odp</extension>
<extension>sxi</extension>
</extensions>
</presentation>
</editable>
<result>Success</result>
<current_api_version>1.2</current_api_version>
</response>
Example 3 (group_by_filetype is set to 'no' JSON response):
Request
http://www.mediafire.com/api/system/get_editable_media.php?response_format=json
Response:
{
"response": {
"action": "system/get_editable_media",
"editable": {
"extensions": [
"doc",
"docx",
"rtf",
"odt",
"sxw",
"html",
"txt",
"xls",
"xlsx",
"sxc",
"ods",
"csv",
"tsv",
"ppt",
"pps",
"odp",
"sxi"
]
},
"result": "Success",
"current_api_version": "1.2"
}
}
Example 4 (group_by_filetype is set to 'yes' JSON response):
Request
http://www.mediafire.com/api/system/get_editable_media.php?group_by_filetype=yes&response_format=json
Response:
{
"response": {
"action": "system/get_editable_media",
"editable": {
"document": {
"extensions": [
"doc",
"docx",
"rtf",
"odt",
"sxw",
"html",
"txt"
]
},
"spreadsheet": {
"extensions": [
"xls",
"xlsx",
"sxc",
"ods",
"csv",
"tsv"
]
},
"presentation": {
"extensions": [
"ppt",
"pps",
"odp",
"sxi"
]
}
},
"result": "Success",
"current_api_version": "1.2"
}
}
Get Info
GET
http://www.mediafire.com/api/1.2/system/get_info.php
POST
http://www.mediafire.com/api/1.2/system/get_info.php
Description: Returns all the configuration data about the MediaFire system.
Required Parameters:
- none
Relative Parameters:
- none
Optional Parameters:
- response_format : 'xml' or 'json' (default 'xml')
Response Properties
| Name | Description | Type |
|---|---|---|
| timezone | The server's timezone. | string |
| timezone_offset | The server timezone offset, in seconds, from UTC. | integer |
| image_sizes | The supported image sizes and the associated thumbnail designation for a particular image size. | list of objects |
| viewable | File formats that can be viewed via MediaFire. | object |
| editable | File formats that can be edited via MediaFire. | object |
| terms_of_service | The most recent terms of service. | object |
| max_keys | The maximum number of resource keys allowed to be passed to file/get_info, file/copy, file/delete, file/move, folder/get_info, folder/copy, folder/delete, folder/move. | integer |
| max_objects | The maximum number of results that can be returned by folder/get_siblings. | integer |
| max_image_size | The maximum file size, in bytes, of an image to be uploaded. | integer |
| result | Indicates if the API call was successful. 'Error' or "Success' | string |
| current_api_version | The latest stable API version number | string |
Error Codes
To view a list of possible error codes for this API, and their descriptions, click here.
Examples:
Example 1 (Success with XML):
Request
http://www.mediafire.com/api/1.2/system/get_info.php
Response
<response>
<action>system/get_info</action>
<timezone>America/Chicago</timezone>
<timezone_offset>-21600</timezone_offset>
<image_sizes>
<image_size>
<width>32</width>
<height>32</height>
<thumbnail>0</thumbnail>
</image_size>
<image_size>
<width>107</width>
<height>80</height>
<thumbnail>1</thumbnail>
</image_size>
...
</image_sizes>
<viewable>
<extensions>
<extension>json</extension>
<extension>doc</extension>
<extension>pdf</extension>
...
</extensions>
</viewable>
<editable>
<extensions>
<extension>json</extension>
<extension>doc</extension>
<extension>rtf</extension>
...
</extensions>
</editable>
<terms_of_service>
<revision>3.2</revision>
<terms>...</terms>
<date>2013-11-01 17:09:06</date>
</terms_of_service>
<max_keys>500</max_keys>
<max_objects>6000</max_objects>
<max_image_size>26214400</max_image_size>
<result>Success</result>
<current_api_version>1.2</current_api_version>
</response>
Example 2 (Success with JSON):
Request
http://www.mediafire.com/api/system/get_info.php?response_format=json
Response
{
"response": {
"action": "system/get_info",
"timezone": "America/Chicago",
"timezone_offset": "-21600",
"image_sizes": [
{
"width": "32",
"height": "32",
"thumbnail": "0"
},
{
"width": "107",
"height": "80",
"thumbnail": "1"
},
...
],
"viewable": {
"extensions": [
"json",
"doc",
"pdf",
...
]
},
"editable": {
"extension": [
"json",
"doc",
"rtf",
...
]
},
"terms_of_service": {
"revision": "3.2",
"terms": ...,
"date": "2013-11-01 17:09:06"
},
"max_keys": "500",
"max_objects": "6000",
"max_image_size": "26214400",
"result": "Success",
"current_api_version": "1.2"
}
}
Get Limits
GET
http://www.mediafire.com/api/1.2/system/get_limits.php
POST
http://www.mediafire.com/api/1.2/system/get_limits.php
Notes: Response property total_folder_items_limit is deprecated in preference to the more aptly named new response property max_synchronous_items.
Obsolete response property daily_shares_limit removed.
Description: Returns a list of various limits that the API honors.
Required Parameters:
- none
Relative Parameters:
- none
Optional Parameters:
- response_format : 'xml' or 'json' (default 'xml')
Response Properties
| Name | Description | Type |
|---|---|---|
| max_keys | The maximum number of resource keys allowed to be passed to file/get_info, file/copy, file/delete, file/move, folder/get_info, folder/copy, folder/delete, folder/move. | integer |
| max_objects | The maximum number of results that can be returned by folder/get_siblings. | integer |
| max_image_size | The maximum file size, in bytes, of an image to be uploaded. | integer |
| zip_max_filesize | The maximum file size, in bytes, of a file to be added to a zip container. | integer |
| zip_max_total_filesize | The maximum file size of the zip container. | integer |
| folder_content_chunk_size | The maximum number of items returned by folder/get_content. | integer |
| folder_depth_limit | The maximum number of chain folders returned by folder/get_depth. | integer |
| limit_search_results | The maximum number of search results returned by folder/search. | integer |
| device_changes_list_limit | The maximum number of changes returned by device/get_changes. | integer |
| total_folder_items_limit | The maximum number of items the system will process synchronously. DEPRECATED (Use max_synchronous_items.) | integer |
| max_synchronous_items | The maximum number of items the system will process synchronously. | integer |
| result | Indicates if the API call was successful. 'Error' or 'Success' | string |
| current_api_version | The latest stable API version number | string |
Error Codes
To view a list of possible error codes for this API, and their descriptions, click here.
Examples:
Example 1 (Success with XML):
Request
http://www.mediafire.com/api/1.2/system/get_limits.php?session_token=d3d60e59f2cc54457c724677eb73d4588d5f7dafdc7c9e34eb21ab67bf2b707f1d73b91e08347c9fb05193454f2ed5d304d0642d730f8e404e5781e0f1c69f17dda9fd40b9dc814d
Response
<response>
<action>system/get_limits</action>
<limits>
<max_objects>6000</max_objects>
<max_keys>500</max_keys>
<max_image_size>26214400</max_image_size>
<zip_max_filesize>314572800</zip_max_filesize>
<zip_max_total_filesize>2147483647</zip_max_total_filesize>
<folder_content_chunk_size>100</folder_content_chunk_size>
<folder_depth_limit>20</folder_depth_limit>
<limit_search_results>100</limit_search_results>
<daily_shares_limit>100</daily_shares_limit>
<device_changes_list_limit>500</device_changes_list_limit>
<total_folder_items_limit>100</total_folder_items_limit>
</limits>
<result>Success</result>
<current_api_version>1.2</current_api_version>
</response>
Example 2 (Success with JSON):
Request
http://www.mediafire.com/api/system/get_limits.php?response_format=json&session_token=d3d60e59f2cc54457c724677eb73d4588d5f7dafdc7c9e34eb21ab67bf2b707f1d73b91e08347c9fb05193454f2ed5d304d0642d730f8e404e5781e0f1c69f17dda9fd40b9dc814d
Response:
{
"response": {
"action": "system/get_limits",
"limits": {
"max_objects": "6000",
"max_keys": "500",
"max_image_size": "26214400",
"zip_max_filesize": "314572800",
"zip_max_total_filesize": "2147483647",
"folder_content_chunk_size": "100",
"folder_depth_limit": "20",
"limit_search_results": "100",
"daily_shares_limit": "100",
"device_changes_list_limit": "500",
"total_folder_items_limit": "100"
},
"result": "Success",
"current_api_version": "1.2"
}
}
Get Mime Types
GET
www.mediafire.com/api/1.2/system/get_mime_types.php
POST
www.mediafire.com/api/1.2/system/get_mime_types.php
Description: Returns a list of file extensions, their document type, and their mime types.
Required Parameters:
- none
Relative Parameters:
- none
Optional Parameters:
- response_format : 'xml' or 'json' (default 'xml')
Response Properties
| Name | Description | Type |
|---|---|---|
| mimetype | The MIME data type information. | list of objects |
| extension | The file extension associated with this MIME data type. More than one extension can be associated with a single MIME data type so there may multiple entries in the response for a particular MIME data type. | string |
| type | The broad type/category of the file. unknown, image, video, audio, document, application, archive, data, development, spreadsheet, presentation. | string |
| view | Specifies if this file is viewable via MediaFire and, if so, by what system. 0 [not-viewable], 1 [PDF Viewer], 2 [PDF Viewer], 3 [deprecated]. | integer |
| edit | Specifies if this file can be edited via MediaFire and, if so, by what system. 0 [not-editable], 1 [Text Editor], 2 [deprecated]. | integer |
| result | Indicates if the API call was successful. 'Error' or 'Success' | string |
| current_api_version | The latest stable API version number | string |
Error Codes
To view a list of possible error codes for this API, and their descriptions, click here.
Examples:
Example 1 (Success with XML):
Request
http://www.mediafire.com/api/system/get_mime_types.php
Response
<response>
<action>system/get_mime_types</action>
<mime_types>
<mime_type>
<mimetype>application/json</mimetype>
<extension>json</extension>
<type>development</type>
<view>1</view>
<edit>1</edit>
</mime_type>
</mime_types>
<result>Success</result>
<current_api_version>1.2</current_api_version>
</response>
Example 2 (Success with JSON):
Request
http://www.mediafire.com/api/system/get_limits.php?response_format=json&session_token=d3d60e59f2cc54457c724677eb73d4588d5f7dafdc7c9e34eb21ab67bf2b707f1d73b91e08347c9fb05193454f2ed5d304d0642d730f8e404e5781e0f1c69f17dda9fd40b9dc814d
Response:
{
"action":"system\/get_mime_types",
"mime_types":[{
"mimetype":"application\/json",
"extension":"json",
"type":"development",
"view":"1",
"edit":"1"
},{
"mimetype":"application\/msword",
"extension":"doc",
"type":"document",
"view":"1",
"edit":"0"
},....{
"mimetype":"audio\/x-hx-aac-adts",
"extension":"aac",
"type":"audio",
"view":"4",
"edit":"0"
},{
"mimetype":"application\/octet-stream",
"extension":"ac3",
"type":"audio",
"view":"4",
"edit":"0"
}],
"result":"Success",
"current_api_version":"1.2"
}
Get Status
GET
http://www.mediafire.com/api/1.2/system/get_status.php
POST
http://www.mediafire.com/api/1.2/system/get_status.php
Description: Returns the current state of the cloud infrastructure.
Required Parameters:
- none
Relative Parameters:
- none
Optional Parameters:
- response_format : 'xml' or 'json' (default 'xml')
Response Properties
| Name | Description | Type |
|---|---|---|
| database | Flag indicating whether the database is 1 [Online] or 2 [Offline or slow]. | integer |
| memcache | Flag indicating whether the memory cache servers are 1 [Online] or 2 [Offline or slow]. | integer |
| result | Indicates if the API call was successful. 'Error' or 'Success' | string |
| current_api_version | The latest stable API version number | string |
Error Codes
To view a list of possible error codes for this API, and their descriptions, click here.
Examples:
Example 1 (Success with XML):
Request
http://www.mediafire.com/api/1.2/system/get_status.php
Response
<response>
<action>system/get_status</action>
<database>1</database>
<memcache>1</memcache>
<result>Success</result>
<current_api_version>1.2</current_api_version>
</response>
1 = online, 0 = offline or slow to respond
Example 2 (Success with JSON):
Request
http://www.mediafire.com/api/system/get_status.php?response_format=json
Response:
{
"response": {
"action": "system/get_status",
"database": "1",
"memcache": "1",
"result": "Success",
"current_api_version": "1.2"
}
}
Get Supported Media
GET
http://www.mediafire.com/api/1.2/system/get_supported_media.php
POST
http://www.mediafire.com/api/1.2/system/get_supported_media.php
Description : Returns the list of all supported document types for preview.
Required Parameters:
- none
Relative Parameters:
- none
Optional Parameters:
- group_by_filetype : groups lists by filetype 'yes' or 'no' (default 'no').
- response_format : 'xml' or 'json' (default 'xml')
Response Properties
| Name | Description | Type |
|---|---|---|
| extensions | The types of files which are supported on MediaFire. | list of strings |
| result | Indicates if the API call was successful. 'Error' or 'Success' | string |
| current_api_version | The latest stable API version number | string |
Error Codes
To view a list of possible error codes for this API, and their descriptions, click here.
Examples:
Example 1 (group_by_filetype is set to 'yes' XML response)
Request
http://www.mediafire.com/api/1.2/system/get_supported_media.php
Response
<response>
<action>system/get_supported_media</action>
<viewable>
<extensions>
<extension>bmp</extension>
<extension>jpeg</extension>
<extension>jpg</extension>
...
...
</extensions>
</viewable>
<result>Success</result>
<current_api_version>1.2</current_api_version>
</response>
Example 2 (group_by_filetype is set to 'yes' XML response):
Request
http://www.mediafire.com/api/1.2/system/get_supported_media.php?group_by_filetype=yes
Response
<response>
<action>system/get_supported_media</action>
<viewable>
<image>
<extensions>
<extension>bmp</extension>
<extension>jpeg</extension>
...
...
</extensions>
</image>
<document>
<extensions>
<extension>doc</extension>
<extension>dot</extension>
...
...
</extensions>
</document>
<spreadsheet>
<extensions>
<extension>xls</extension>
<extension>xlw</extension>
...
...
</extensions>
</spreadsheet>
<presentation>
<extensions>
<extension>ppt</extension>
<extension>pps</extension>
...
...
</extensions>
</presentation>
</viewable>
<result>Success</result>
<current_api_version>1.2</current_api_version>
</response>
Example 3 (group_by_filetype is set to 'yes' JSON response):
Request
http://www.mediafire.com/api/system/get_supported_media.php?group_by_filetype=yes
Response:
{
"action":"system\/get_supported_media",
"viewable":{
"development":{
"extensions":[
"json","css","js","pl","sh","tcl","xhtml","xhtm","html","htm","h","cc","cxx","xml","cpp","php","c","php3","php4","php5","phps","ini",
"bat","bsh","cob","hpp","java","jsp","mak","phtml","phtml","phtml","phtml","py","shtml","shtml","sql","vb","vbs","vbs","vbs","conf","inf"
]
},"document":{
"extensions":[
"doc","pdf","rtf","odt","docm","docx","dotx","sxw","wps","txt","asc","text","rtf","rtf","doc","abw"
]
},"spreadsheet":{
"extensions":[
"xls","ods","csv","tsv","xlsm","xlsx","xltx","wks","csv"
]
},"presentation":{
"extensions":[
"ppt","odg","odp","ppsm","ppsx","sxi","pptx","pps"
]
},"audio":{
"extensions":[
"ac3","wma","wav","mp3","ogg","aiff","zzz","ogg","mp3","wma","oga","wma","m4a","m4a","ogg","aac","ac3"
]
},"image":{
"extensions":[
"gif","png","bmp","tga","jpg","jpeg","jpe","tiff","tif"
]
},"video":{
"extensions":[
"ogv","webm","flv","wmv","avi","3gp","3gpp","3g2","3gpp2","mp4","mpg4","mpeg","mpg","mov","mod","m4v","vob","m4v","mp4","ogv","avi","mpg","ogv","flv","3gp","vob","wmv"
]
}
},
"result":"Success",
"current_api_version":"1.2"
}
Example 4 (group_by_filetype is set to 'no' JSON response):
Request
http://www.mediafire.com/api/system/get_supported_media.php?response_format=json
Response:
{
"response": {
"action": "system/get_supported_media",
"viewable": {
"extensions": [
"bmp",
"jpeg",
"jpg",
...
]
},
"result": "Success",
"current_api_version": "1.2"
}
}
Get Version
GET
http://www.mediafire.com/api/1.2/system/get_version.php
POST
http://www.mediafire.com/api/1.2/system/get_version.php
Description : Returns the current API version (major.minor).
Required Parameters:
- none:
Relative Parameters:
- none:
Optional Parameters:
- response_format : 'xml' or 'json' (default 'xml')
Response Properties
| Name | Description | Type |
|---|---|---|
| result | Indicates if the API call was successful. 'Error' or 'Success' | string |
| current_api_version | The latest stable API version number | string |
Error Codes
To view a list of possible error codes for this API, and their descriptions, click here.
Examples:
Example 1 (Success with XML):
Request
http://www.mediafire.com/api/1.2/system/get_version.php
Response
<response>
<action>system/get_version</action>
<current_api_version>1.2</current_api_version>
<result>Success</result>
</response>
Example 2 (Success with JSON):
Request
http://www.mediafire.com/api/1.2/system/get_version.php?response_format=json
Response:
{
"response": {
"action": "system/get_version",
"current_api_version": "1.2",
"result": "Success"
}
}