security.setAccess

This method is part of iPaper Secure. For more information about iPaper Secure, see the complete documentation.

This method allows you to disable a user's access to a secure document, or to re-enable it after a previous call. It is not necessary to grant initial access to a document - that is done through the embed code.

Parameters

string user_identifier (required) Your user identifier; should be the same as what is used in the embed code.
{0, 1} allowed (required) If 0, disables access; if 1, re-enables access.
integer doc_id (optional) The document ID to disable/re-enable access to. If no doc_id is provided, the method call will act on all documents that the given user_identifier has access to. Not providing a doc_id is a good way to globally disable access for a user in your system.
string api_key (required) API key assigned to your account.
string api_sig (optional) MD5 hash of the active request and your secret key. This is an optional security measure. See the signing documentation for more info.

Sample return XML

    <?xml version="1.0" encoding="UTF-8"?>
    <rsp stat="ok">
    </rsp>

Result explanation

Error codes

401 Unauthorized
500 Internal Server Error. Scribd has been notified about this problem.
601 Required parameter missing
611 Insufficient permissions to access this document
612 Document could not be found
629 Attempt to call a secure method on a non-secure document
650 Invalid parameter value