The process demonstrates how to embed Quickwork in your product.
Skill level: Expert
Time required: 30 minutes
Postman desktop app to use the APIs
Partner APIs: You can obtain these by contacting Quickwork Relationship Manager
There are two partner APIs using which a new user and an existing user can get an associated JWT token, respectively to access Quickwork.
JSON Web Token (JWT) is an open standard authorization token that defines a compact and self-contained way for securely transmitting information between parties as a JSON object. As it is digitally signed, this information is verified and trustworthy.
The Create User API lets you register a new partner/user and returns a JWT token to access the platform. To do so, open the partner APIs in your postman account and click the Create User API. Then, switch to the Body tab and ensure that the raw button is selected as a beautifier. You'll see three input fields to register a user. Enter the
uniqueID of the user:
The unique ID is a mandatory field and could be an employee ID, partner ID, or register ID.
lastname field is optional.
Once specified, click the Send button:
In the response, you'll get a JWT token. Take note of it as this token lasts for 24 hours only.
The Get Users JWT Token API gives you the JWT token of an existing user. To get it, click the API, switch to the Body tab and ensure that the raw button is selected as a beautifier. You'll see
uniqueID as the only input field. Specify the ID and click on the Send button:
In the response, you'll get a JWT token. Take a note of it as this token lasts for 24 hours only. This API returns a
404 User not found error if you specify an ID of an unregistered user.
In this way, we received the JWT token for a new user and an existing user. Now, let's use this token to access the platform functionality.
To start working with SDKs, import the Quickwork Framework and Quickwork SDK in your web project.
Open the Quickwork SDK file in an editor and search for the
Quickwork.setUser() method. Paste the JWT token of a new/existing user within the double quotes of this method:
Now, search for the
Quickwork.navigateTo() method. A value passed to this method redirects the user to the dedicated functionality of Quickwork. Currently, there are four features of Quickwork that are accessible for partners/users through this SDK file:
projects: Redirects the user to the Folders.
api-management: Redirects the user to the API Management.
databases: Redirects the user to the Databases.
constants: Redirects the user to the Constants.
Pass any feature value, say
projects as a value to the
Save the changes of this SDK file, close the editor mode, and open it in a browser tab. The user whose JWT token you've specified will be redirected to the Folders screen on Quickwork: