TinyLoad has an Application Programming Interface for exposing its file distribution system – it’s extremely simple. This page serves as a development reference to extend our service into your remote applications.

All parameters should be converted to a UTF-8 and pass through a URL encode function if data contains complex strings.

Available Methods: Transfer, Upload (documentation available soon).

Transfer File

URL: http://tinyload.com/api/1.0/transload.{format}?url={file}

Request Method: GET

Response Format: xml, json, txt

Parameters

• URL (required): URL of file to distribute. Be sure to URL encode.

Example Request: http://tinyload.com/api/1.0/transload.xml?url=http://site.com/logo.gif

• Name (optional): Set custom filename. Default is url substring after the last slash. Example: http://site.com/imgs/funny/logo.gif becomes logo.gif

Example Request: http://tinyload.com/api/1.0/transload.xml?url=http://site.com/logo.gif&name=Site%20Logo.gif

• Force (optional): Will overwrite file regardless of being unique. Default is False. Options: true or false.

Example Request: http://tinyload.com/api/1.0/transload.xml?url=http://site.com/logo.gif&force=true

• Sites (optional): Destination sites for transfer. Format: site ids delimited by commas. Default is '1,2,3,4' which by will transfer file to Megaupload, Mediafire, Rapidshare, and Divshare. See the table below for a complete list of available Site Ids.

Example Request: http://tinyload.com/api/1.0/transload.xml?url=http://site.com/logo.gif&sites=1,2,10 will upload to Megaupload, Mediafire, and Amazon S3.

Response if Success

• XML

<?xml version="1.0" encoding="UTF-8"?>

<response>

     <status>200</status>

     <link>http://tinyload.com/{id}</link>

</response>

• JSON

{

     "status": 200,

     "link": "http://tinyload.com/{id}"

}

• TXT

200

http://tinyload.com/{id}

Response if Error

• XML

<?xml version="1.0" encoding="UTF-8"?>

<response>

     <status>400</status>

     <field>field</field>

     <message>Error Message</message>

</response>

• JSON

{

     "status": 400,

     "field": Field,

     "message": Error Message

}

• TXT

400

Field

Error Message

Explanation of Response Errors

• Status: Corresponds with standard HTTP Error Code 400
• Field: Which Parameter caused the error
• Message: Details about why the Parameter caused an error

Coming Soon

• Upload Method: Ability to post form with multipart/form-data file
• Callback URL: Ping notification of successful upload to remote site ie: http://megaupload.com/?d=JT1E4GAX
• Embeddable Widget: Flash / Javascript widget containing links to distributed file
• More Ideas? Let us know

Questions / Contact

• Email: tinyload.com at gmail dot com