This package is used to parse the Wix Instance in the backend of a Wix application.
In your Wix app, send the unparsed instance along with each request from the client side to your server. On the server, use this package to verify that the instance actually came from Wix to guarentee that the request is valid.
import wixinstance #Get the instance ID. instance_ID = wixinstance.get_instance_ID(YOUR_APP_SECRET, INSTANCE, check_owner) if instance_ID: #process the request because it is valid else: #reject the request because it is invalid #Get the entire parsed instance object parsed_instance = wixinstance.instance_parser(YOUR_APP_SECRET, INSTANCE) if parsed_instance: #process the request because it is valid else: #reject the request because it is invalid
Use this function when you need the instance ID of the parsed instance. The instance ID is returned as a Unicode string.
The function takes in a third argument called check_owner which is a boolean that tells the function whether or not to check if the instance was generated by the owner of the site or a site visitor. Use this to verify requests that only the owner of a site can make (e.g. changing app settings).
The function returns false if the instance is invalid or if the instance was not generated by the site owner (assuming site_owner is set to True).
Use this function when you want the entire parsed instance. The parsed instance is returned as a dictionary. The keys to the dictionary are equivalent to the Instance properties in the Wix Documentation.