Home iPaper Documentation Resources FAQ Login

Documentation
Overview Scribd API
Overview Authentication Signing

API Methods
docs.upload docs.uploadFromUrl docs.getList docs.getConversionStatus docs.getSettings docs.changeSettings docs.delete docs.search user.login user.signup

QuickSwitch iPaper Javascript API Slurp

docs.uploadFromUrl
This method retrieves the document file from the specified URL.

Parameters
string url ["pdf", doc_type "doc", "txt", "ppt", etc] ["public", access "private"] int rev_id string api_key (required) (optional) Identify the document type with what the extension *would* be for this file.

(optional) Default: "public". (optional) The doc_id to save uploaded file as a revision to. (required) API key assigned to your account.

string

api_sig

string

string

(optional) MD5 hash of the active request and your secret key. This is an optional security measure. See the security documentation page. for more info. session_key (optional) A session key for a signed in user. If this parameter is provided, your application will carry out actions on behalf of the signed in user corresponding to the session key. Otherwise, your application will carry out actions on behalf of the user account associated with the API account. See the authentication documentation. for more information my_user_id (optional) This parameter is intended for sites with their own user authentication system. You can create phantom Scribd accounts that correspond to your users by simply passing the unique identifier you use to identify your own user accounts to my_user_id. If you pass this parameter to an API method, the API will act as if it were executed by the phantom user corresponding to my_user_id. See the authentication documentation for more information.

Sample return XML
<?xml version='1.0' encoding='UTF-8'?> <rsp stat='ok'> <doc_id>123456</doc_id> <access_key>key-rvfa2c82sq5bf9q8t6v</access_key> <secret_password>2jzwhplozu43cyqfky1m</secret_password>

Result explanation
int Every document on Scribd is referenced by a unique ID. You can use the ID of a document to request more information about it or to link to it on Scribd string access_key Every document on Scribd has a unique, secure access key. You must know the access key of a document to embed it. string secret_password Private documents on Scribd have a secret password. You use the secret password of a private document to link to the private page of the document on Scribd. This parameter will only be present if the document is private. doc_id

</rsp>

Error codes
401 Unauthorized 500 Internal Server Error. Scribd has been notified about this problem. 601 Required parameter missing 602 Unrecognized or blank file extension 603 No file data was sent

606 Problem downloading file

Terms Copyright © 2007 About FAQ Platform Contact Blog Store Jobs