sendspace Developer | Documentation

Home API Howto Full API Guide API Keys Downloads API Support

sendspace API (beta) Developer Guide The sendspace Application Programming Interface (API) allows you to embed sendspace services in your applications, programs, or scripts, regardless of platform and programming language. All communication with the sendspace API (beta) assumes a UTF-8 encoding.

< Return to Method List

Method: auth.login

Description

Starts a session and returns user API method capabilities -- which features the given user can and cannot use.

Arguments

Name	Mandatory	Description
token	Yes	Received on create token
user_name	Yes	Registered user name
tokened_password	Yes	lowercase(md5(token+lowercase(md5(password)))) - md5 values should always be lowercase.

Returns

session_key to be sent with all method calls, user information, including the user account's capabilities

Response

 
<result method="auth.login" status="ok">
    <session_key>XXXX</session_key>
    <email>XXXX</email>
    <membership_type>pro/max/lite</membership_type>
    <membership_ends>4534535</membership_ends>
    <capable_upload>0/1</capable_upload>
    <capable_download>0/1</capable_download>
    <capable_folders>0/1</capable_folders>
    <capable_files>0/1</capable_files>
    <bandwidth_left>bytes/-1=unlimited</bandwidth_left>
    <diskspace_left>bytes/-1=unlimited</diskspace_left>
</result>

Usage Example

 
http://api.sendspace.com/rest/?method=auth.login&token=57md654jwfl6l25idskzh8x3b5zwp46k&user_name=testuser&tokened_password=2cb501e4j86ef8ad17f6b26b90ee5764

Possible Errors

Code	Name	Description
6	API_ERROR_SESSION_BAD	Session expired or not found
8	API_ERROR_AUTHENTICATION_FAILURE	Authentication error
11	API_ERROR_PERMISSION_DENIED	Permission denied