Once you've created a client, your client can generate, manage, and use tokens for anonymous site visitors. The client uses these tokens when making requests to Wix APIs on behalf of a visitor to maintain the visitor's session.
When you create a client, new visitor tokens are automatically generated and set to the client, creating a new visitor session, if you don't specify that the client should use existing tokens. If you want a new client to resume a previous visitor session, you need to provide the client with the tokens previously used in that session.
Once tokens are set for a client, the client manages the tokens, generating new access tokens when necessary, without you needing to do anything. However, if you want, you can manually handle visitor tokens as well.
A client will automatically generate new visitor tokens if you don't pass any tokens to it when you create the client.
Alternatively, use a client's generateVisitorTokens() method to generate an access token and a refresh token for an anonymous visitor.
The function returns a promise that resolves to an object containing:
For example:
If you want to be able to restore the current session at some point later, store your client's tokens locally, for example in localStorage, a cookie, or a local file.
Get a client's current tokens using getTokens() or generate new ones using generateVisitorTokens().
Once you have tokens, they are mostly managed by the client. If you want to manually confirm or renew an access token you can pass your tokens as arguments to generateVisitorTokens().
generateVisitorTokens() returns the existing valid access token and refresh token.generateVisitorTokens() returns the existing refresh token and a newly generated access token.generateVisitorTokens() returns a new refresh token and a new access token.Alternatively, you can use renewToken() to generate a new access token for an existing refresh token without checking whether the existing access token is valid.
If you already have visitor tokens, you can use them to resume a visitor's session.
You can resume a session when creating a client by passing it existing tokens, as in this example that reads the tokens from a cookie.
Or, if you already have tokens and a client, you can resume a visitor session by calling setTokens() to set the tokens as the active tokens for your client.
Once tokens are set, every call made by your client uses these tokens. This means that the visitor's data is preserved and associated with these tokens. For example, items added to a cart, or tickets the visitor reserves, are reflected in future calls made by a client using the same tokens.
To retrieve the tokens currently set to the client, use getTokens().