Postman

What is Postman?

Postman is an API platform for building and using APIs. Postman simplifies each step of the API lifecycle and streamlines collaboration so you can create better APIs—faster.

More Information

Learn more about Postman

This API tool can be used to debug and check the functionality of API requests to the AnalyticsAPI.

It is an easy to use tool and can be configured to send any API request.

Example GET request via Postman:

  1. Open Postman and Sign In or Create an Account

  2. Create a collection of requests

  3. Create a request
    ../../../../../../_images/collection.png
  4. Add Authorization method:
    1. Go to Authorization tab

    2. Select OAuth2 from the dropdown list

    ../../../../../../_images/authorization.png
  5. Fill in the necessary information for the authorization using the Login Service

    Important

    Login Service should be running on localhost

    1. Grant Type: Password Credentials

    2. Access Token URL: https:localhost:44355/connect/token

    3. Client ID: UnityModuleWithoutSSO

    4. Client Secret: unity.module.without.sso.2020

    5. Username: admin1

    6. Password: admin@2020

    7. Client Authorization: Send as Basic Header Auth

    8. Click the “Get New Access Token” button at the end of the page

    9. After authorization succeeds, click the “Proceed” button

    10. A window will appear showing the access token you received during authorization. Click “Use Token”
      ../../../../../../_images/access_token.png
  6. Go to the Headers Tab
    1. Click to show the hidden headers

    2. It should have an Authorization Header Authorization Bearer ey...

  7. Type the request URL

    Hint

    As an example use https://localhost:44355/api/users/current

    This request should return information about the logged in user

  8. Go to Postman Settings and disable SSL certificate verification
    ../../../../../../_images/ssl_verification.png
  9. Click “Send”

  10. It should return a response with code 200 (OK)

  11. The response will be displayed in json format within the postman window

Hint

This process can be used for any request to both LoginAzure and AnalyticsAPI projects