Quickwork Embedded - Getting Started

Quickwork provides a no-code SaaS platform to integrate Logger by Quickwork with other apps, databases and APIs to automate business and consumer workflows.

The process demonstrates how to embed Quickwork Journey Builder in your product.

What you'll need:

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 Journey Builder.

What is a JWT token?

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.

Registering a new user to get the associated JWT token

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 firstname, lastname, and uniqueID of the user:

  1. The unique ID is a mandatory field and could be an employee ID, partner ID, or register ID.

  2. The firstname and lastname field is optional.

Once specified, click the Send button:

Figure 1: Create User API

In the response, you'll get a JWT token. Take note of it as this token lasts for 24 hours only.

Get a JWT token of an existing user

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 the Send button:

Figure 2: Get Users JWT Token API

In the response, you'll get a JWT token. Take 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.

Working with Quickwork Embedded SDK

To start working with SDKs, import the Quickwork Framework and Quickwork SDK in your web project.

Pasting the received token in an SDK file

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:

Quickwork.setUser("JWT_token_of_a_new_or_existing_user");

Setting the navigation

Now, search for the Quickwork.navigateTo() method. A value passed to this method redirects the user to the dedicated functionality of Quickwork Journey Builder. Currently, there are four features of Quickwork Journey Builder that are accessible for partners/users through this SDK file:

  1. projects: Redirects the user to the Projects screen.

  2. api-management: Redirects the user to the API Management screen.

  3. databases: Redirects the user to the Databases screen.

  4. constants: Redirects the user to the Constants screen.

Pass any feature value, say projects as a value to the Quickwork.navigateTo() method:

Quickwork.navigateTo('projects');

Only one value at a time can be defined within this method to access the associated feature. You cannot define two or more above-listed functionalities on one go.

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 Projects screen on Quickwork Journey Builder:

Figure 3: The Projects screen