Authorization URLs direct your users to WAX Cloud Wallet (from a browser). Your customers can create a new account or sign in, then use this URL to grant your app access to various OAuth Scopes.
The Authorization URL includes the following parameters:
|client_id||client_id=xxxx999x9999||Required. The client_id for your app.|
|state||&state=1234567||Required. A random value that you've generated and stored securely (either in client memory for apps that run on a client device or in a server-side session for apps that run on a server).|
|duration||&duration=permanent||Optional. Only use duration=permanent for one-time "Link your Account with WAX" requests. Access can be revoked by the user on their account page. Omit for signing in users. Refer to OAuth Token Duration for more information.|
|mobile||&mobile=1||The literal string 1. Include this if you're prompting the user in a mobile or embedded environment; this removes the navigation bar from the authorization page.|
|scope||&scope=identity+items||A space-separated list of OAuth Scopes that you're requesting access to. If omitted, defaults to only
Create Your URL
To create your Authorization URL:
Choose your environment.
Environment Link Production https://api-idm.wax.io/v1/authorize
Determine your token duration (permanent or one-time sign in). Refer to OAuth Token Duration for more information.
Choose your OAuth Scopes.
Authorization URL Example
If your Authorization client_id is invalid, the following message displays to your users:
OAuth client not found
Now that you’ve created your Authorization URL, it’s time to handle the redirect_uri query string and exchange your Authorization code for a Bearer Token.