System1.0

Get Editable Media


Description : Returns a list of all supported documents for editing.

Required Parameters

  • none

Optional Parameters
  • group_by_filetype : Groups lists by filetype 'yes' or 'no' (default 'no').
  • response_format : 'xml' or 'json' (default 'xml')


GET http://www.mediafire.com/api/1.0/system/get_editable_media.php
POST http://www.mediafire.com/api/1.0/system/get_editable_media.php

Example 1 (defaults to not being grouped by filetype):

Request
http://www.mediafire.com/api/1.0/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.0</current_api_version>
</response>

Example 2 (group_by_file is set to yes):

Request
http://www.mediafire.com/api/1.0/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.0</current_api_version>
</response>


Get Info


Description: Returns all the configuration data about the MediaFire system.

Required Parameters:

  • none

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

The Response Includes:
  • The server time zone and its current offset, in seconds, from UTC.
  • The supported image sizes and the associated thumbnail designation for a particular image size.
  • The lists of file extensions organized in the categories 'viewable' and 'editable'.
  • The most recent terms of service.
  • The maximum number of keys, the maximum number of objects, and the maximum image size.
    Description of the Limits:
    • max_keys The maximum number of quickkeys and folderkeys allowed to be passed to file/get_info, file/copy, file/delete, file/move, folder/get_info, folder/copy, folder/delete, and folder/move.
    • max_objects : The maximum number of items that can be returned by folder/get_siblings.
    • max_image_size : The maximum file size of an image to be uploaded.

    • GET http://www.mediafire.com/api/1.0/system/get_info.php
      POST http://www.mediafire.com/api/1.0/system/get_info.php

      Example:

      Request
      http://www.mediafire.com/api/1.0/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.0</current_api_version> 
      </response>

      Get Limits


      Description: Returns a list of various limits that the API honors.

      Required Parameters:

      • none

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

      Description of the limits :
      • max_objects : The maximum number of items that can be returned by folder/get_siblings.
      • max_keys : The maximum number of quick_keys and folderkeys allowed to be passed to file/get_info, file/copy, file/delete, file/move, folder/get_info, folder/copy, folder/delete, and folder/move.
      • max_image_size : The maximum filesize of an image to be uploaded.
      • zip_max_filesize : The maximum size of individual files that can be added to the zip file.
      • zip_max_total_filesize : The maximum total size of the zip file.
      • folder_content_chunk_size : The maximum number of items returned by folder/get_content.
      • folder_depth_limit : The maximum number of items in the depth chain returned by folder/get_depth.
      • limit_search_results : The maximum number of search results returned by folder/search.
      • daily_shares_limit : The maximum number of collaboration shares allowed per day. OBSOLETE
      • device_changes_list_limit : The grouping size of a device changes list returned by device/get_changes.


      GET http://www.mediafire.com/api/1.0/system/get_limits.php
      POST http://www.mediafire.com/api/1.0/system/get_limits.php

      Example:

      Request
      http://www.mediafire.com/api/1.0/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>
          </limits>
          <result>Success</result>
          <current_api_version>1.0</current_api_version>
      </response>

      Get Mime Types


      Description: Returns a list of file extensions, their document type, and their mime types.

      Required Parameters:

      • none

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


      GET www.mediafire.com/api/1.0/system/get_mime_types.php
      POST www.mediafire.com/api/1.0/system/get_mime_types.php

      Example:

      Request
      http://www.mediafire.com/api/1.0/user/get_info.php?session_token=123456789012345678901234567890123456789012345678901234567890&version=1
      
      Response
      <response>
          <action>system/get_mime_types</action>
          <mime_types>
              <mime_type>
                  <extension>.3dm</extension>
                  <category>other</category>
                  <type>application/world</type>
              </mime_type>
              <mime_type>
                          <extension>.3dmf</extension>
                          <category>other</category>
                          <type>application/world</type>
                  </mime_type>
                  <mime_type>
                          <extension>.3g2</extension>
                          lt;category>video</category>
                          <type>video/3gp2</type>
                  </mime_type>
                  <mime_type>
                          <extension>.3gp</extension>
                          <category>video</category>
                          <type>video/3gpp</type>
                  </mime_type>
                  <mime_type>
                          <extension>.a</extension>
                          <category>other</category>
                          <type>application/octet-stream</type>
                  </mime_type>
                  <mime_type>
                          <extension>.aab</extension>
                          <category>other</category>
                          <type>application/authorware-bin</type>
                  </mime_type>
                  . . .
                  <mime_type>
                          <extension>.zsh</extension>
                          <category>text</category>
                          <type>text/script.zsh</type>
                  </mime_type>
          </mime_types>
          <result>Success</result>
          <current_api_version>1.0</current_api_version>
      </response>

      Get Status


      Description: Returns the current state of the cloud infrastructure.

      Required Parameters:

      • none

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


      GET http://www.mediafire.com/api/1.0/system/get_status.php
      POST http://www.mediafire.com/api/1.0/system/get_status.php

      Example:

      Request
      http://www.mediafire.com/api/1.0/system/get_status.php
      
      Response
      <response>
          <action>system/get_status</action>
          <database>1</database>
          <memcache>1</memcache>
          <result>Success</result>
          <current_api_version>1.0</current_api_version>
      </response>

      1 = online, 0 = offline or slow to respond


      Get Supported Media


      Description : Returns the list of all supported document types for preview.

      Required Parameters:

      • none

      Optional Parameters:
      • group_by_filetype : groups lists by filetype 'yes' or 'no' (default 'no').
      • response_format : 'xml' or 'json' (default 'xml')


      GET http://www.mediafire.com/api/1.0/system/get_supported_media.php
      POST http://www.mediafire.com/api/1.0/system/get_supported_media.php

      Example 1 (defaults to not being grouped by filetype):


      Request
      http://www.mediafire.com/api/1.0/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.0</current_api_version>
      </response>

      Example 2 (group_by_filetype is set to yes):

      Request
      http://www.mediafire.com/api/1.0/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.0</current_api_version>
      </response>

      Get Version


      Description : Returns the current API version (major.minor).

      Required Parameters:

      • none:

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


      GET http://www.mediafire.com/api/1.0/system/get_version.php
      POST http://www.mediafire.com/api/1.0/system/get_version.php

      Example:

      Request
      http://www.mediafire.com/api/1.0/system/get_version.php
      
      Response
      <response>
          <action>system/get_version</action>
          <current_api_version>1.0</current_api_version>
          <result>Success</result>
      </response>