Commit 0971f782 by Marlon

Update README.mkd with SessionToken documentation.

parent f318a69d
......@@ -496,4 +496,23 @@ admin_role.save()
This, for example, creates a role with the name 'moderators', with an ACL that allows the public to read but not write to this role object.
Session Tokens
---------------
When querying or updating an object protected by an ACL, parse.com requires the session token of the user with read and write privileges, respectively. You can pass the session token to such queries and updates by using the `parse_rest.connection.SessionToken` class.
~~~~~ {python}
from parse_rest.connection import SessionToken
from parse_rest.user import User
u = User.login('dhelmet', '12345')
token = u.sessionToken
with SessionToken(token):
collectedItem = CollectedItem.Query.get(type="Sword") # Get a collected item, Sword, that is protected by ACL
print collectedItem
~~~~~
Assuming the CollectedItem 'Sword' is read-protected from the public by an ACL and is readable only by the user, SessionToken allows the user to bypass the ACL and get the 'Sword' item.
That's it! This is a first try at a Python library for Parse, and is probably not bug-free. If you run into any issues, please get in touch -- dgrtwo@princeton.edu. Thanks!
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment