Connect cross-platform accounts & identity management
Follow the steps below to get authorized in Swagger, so that you can test our API endpoints.
In the Admin Portal, open the Platform Configurations menu in the top-right corner of the screen, and click OAuth Clients. Browse the list of clients to find the one you’d like to use to access the endpoints, and click View next to the client to open it. In the Client Details window, copy the Client ID. Make note of the namespace the client is located in as well; you’ll need this information later.
Open the Swagger page for the service you want to access. You can find a list of each of our Swagger pages on our API endpoints page. When you’ve navigated to the desired Swagger page, click the green Authorize button in the top-right corner of the screen.
The Available Authorizations window that appears contains two options: Authorization (APIKey) and Basic Authorization. Paste the Client ID from earlier into the Username box under Basic Authorization and click the Authorize button.
Make sure to type something into the Password field under Basic authorization and then delete it before pressing Authorize. Otherwise, Swagger will denote the password as undefined rather than an empty string, which will prevent logging in.
Use the https://demo.accelbyte.io/iam/apidocs/#/OAuth2.0/TokenGrantV3 endpoint. Click Try Out Now and then do the following:
When you’re done, click Execute. Upon successful request, your access token will be returned in the server response.
Copy the contents of the access_token field in the server response. This will be a very long string, as seen in the image above.
Return to the Available Authorizations window by clicking the green Authorize icon in the top-right corner of the Swagger page. In the Authorization (APIKey) section, type the word “Bearer” (must be capitalized), followed by one space, then paste your access token. Then, click Authorize.
Finally, click Logout in the Basic Authorization section. Now you can test the API endpoints in Swagger.
If you use curl, you can also get an access token for Swagger using the code below.
Then hit Enter.
Here is an example response to a successful request:
You can copy the access_token value from the response and paste it into Swagger preceded by the word BEARER, as in step 6 of the Get Authorized in Swagger tutorial above.