Skip to Content

Set Up Postman to Call Service Ticket Intelligence APIs

test
0 %
Set Up Postman to Call Service Ticket Intelligence APIs
Details

Set Up Postman to Call Service Ticket Intelligence APIs

July 9, 2020
Created by
July 9, 2020
Adjust and import Postman environment and collection templates to call the Service Ticket Intelligence APIs.

You will learn

  • What Postman environments and collections are and how to use them
  • How to adjust the Postman environment for your service instance
  • How to import Postman environments and collections

In the following tutorials Postman is used to communicate and interact with your Service Ticket Intelligence service instance. Postman is an API client you use to call APIs. For more information, see Postman.


Step 1: Add service key credentials to Postman environment

Postman offers the option to add environments. Environments represent key-value pairs which can be reused in requests, so you don’t have to remember them. For more information, see Postman Environments.

You can use this feature to store your service key details created in Create Service Instance for Service Ticket Intelligence and reuse them in your requests to your service instance.

Make a local copy of the environment template for Service Ticket Intelligence available on GitHub:

  1. Open the environment template.

  2. Click Raw.

  3. Right click and then click Save link as to download locally the JSON file.

Open the downloaded JSON file in an editor of your choice. Then, insert the following values from your service key into the corresponding spaces of the template:

Service key property Property in template
url (inside the uaa section of the service key) uaa_url
url (outside the uaa section of the service key) sti_service_url
Service KeysPostman Key

Save the changes in the JSON file.

Now the Postman environment is ready to be used.

Log on to answer question
Step 2: Import the Postman environment

Open Postman and click Import to open the import dialog.

Postman Home

In the dialog, select the tab Import File and then click Choose Files to upload your environment file.

Postman Import

Alternatively, you can select the tab Paste Raw Text and paste the text from your environment file directly in the available text area.

After you have imported the environment, a message appears to inform you about the successful import.

Your new environment now shows up in the dropdown menu and can be selected.

Postman Environment List

You have successfully imported the Postman environment for Service Ticket Intelligence.

Log on to answer question
Step 3: Import the Postman collection

Collections let you group requests together and save them for later use. This helps with the organization of requests as well as sharing requests. For more information, see Postman Collections.

To get started, make a local copy of the collection template for Service Ticket Intelligence available on GitHub. There is no need to adjust anything.

Import the collection the same way as you did for the environment in the previous step.

After you have imported the collection, it will appear on the left. As previously explained, the folder STI sample collection contains requests which you can use to call the Service Ticket Intelligence APIs.

Postman Collections

You have successfully imported the Postman collection for Service Ticket Intelligence.

Log on to answer question
Step 4: Select the environment

Finally, make sure to select the Env for STI sample collection environment in the dropdown menu. Otherwise you will not be able to use the requests in the collection.

Postman Environment Selection
Log on to answer question
Step 5: Test yourself
Where do you enter your service key details?
×

Next Steps

Back to top