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 (1.2) assumes a UTF-8 encoding.
< Return to Method List
Method: files.getInfo
- Description
Gets information about a specific file.
- Arguments
Name | Mandatory | Description |
session_key | Yes | Received from auth.login |
file_id | Yes | file_id or list of files id's (a1a1a1,s2s2s2,d3d3d3) |
- Returns
Full file information including size, upload date, download URLs & number of downloads, password property present if protection was set. The property business_shared=1 will be returned if granted access to team, but not_owned=1 if file acessed by unprivileged member, in such case delete_url and password properties will be absent.
- Response
<!-- successful response -->
<result method="files.getInfo" status="ok">
<file id="" name="" description="" password="" folder_id="" download_page_url="" direct_download_url="" delete_url="" upload_time="" file_size="" downloads="" time_limit="" download_limit="" limit_action="" limit_action_to_folder="" business_shared="" not_owned="" />
</result>
<!-- failed response -->
<result method="files.getinfo" status="fail">
<error code="9" text="File not found"/>
<id>u5txwy</id>
</result>
- Usage Example
http://api.sendspace.com/rest/?method=files.getinfo&session_key=9i96woykgory1crglmykgycjwa5k2cq2&file_id=hklv47
- Possible Errors
Code | Name | Description |
6 | API_ERROR_SESSION_BAD | Session expired or not found |
9 | API_ERROR_FILE_NOT_FOUND | File not found |