security.getDocumentAccessList

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

This method can be used for tracking and verification purposes. It gets the list of the user_identifiers currently authorized to view the given document.

Parameters

integer doc_id (required) The Document ID of the document. Must be a secure document.
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">
      <result_set list="true">
        <result>
          <user_identifier>leila83</user_identifier>
        </result>
        <result>
          <user_identifier>spikyhairdude</user_identifier>
        </result>
      </result_set>
    </rsp>

Result explanation

list result Contains each individual result
string user_identifier A user identifier of a user authorized to view the document.

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