sendspace API (beta) Howto

Before you can use the sendspace API, you will need to register for an API key. Creating your free key is easy; you just need to have a sendspace account first, login, and go to API Keys.

• The sendspace API is using REST. All actions should access http://api.sendspace.com/rest/
• Every method requires that certain arguments are used. Mandatory arguments must be sent. Non-mandatory can be omitted.
• All communication with the sendspace API (beta) assumes a UTF-8 encoding and all methods will return a similarly encoded XML response.
• The arguments, responses and error codes for each method are listed on the method's specification page. Methods are listed in the Full API Guide.
• All XML responses are always enclosed in a <result> root element that will hold the method name and the status of the action (OK/Fail).
• All responses, successful or not, will always return the id of the a file/folder to make it possible to call a few parallel actions.
• Dates and times are returned in the following formats: "YYYY/MM/DD HH:MM:SS". Times follow EST.

Most methods also require a session_key. A session_key is created in auth.login after a successful authentication.

Authentication procedure:

1. Send auth.createtoken with api & app information.
2. Receive token.
3. Send auth.login with user information and the received token.
4. Receive a session_key.
5. Use session_key with all other methods.

We recommended that you use the auth.logout method when the user chooses to exit your application, whenever possible.

Please keep the user session_key in memory/cookie and don't use the full authentication procedure for every method. Reuse the provided session_key.

There is no need to check a session (auth.checksession) before every call. In the case that the session is expired, an error will be returned.

Calling a method:

http://api.sendspace.com/rest/?method=files.getinfo&session_key=e7s8jvvj5n5u60qm4l6rzkax3a4ucpcg&file_id=6wnhxi

Successful response:

 
<result method="files.getinfo" status="ok">
        <file id="6wnAVV" name="sendspace_api.txt" description="" password="" file_size="231945" upload_time="1185443691" downloads="0" folder_id="0" direct_download_url="" download_page_url="http://www.sendspace.com/file/6wnAVV"/>
</result>

Bad response (unknown method):

 
<result method="files.getinfos" status="fail">
        <error code="2" text="Unknown method"/>
</result>