Postman Instructions to test Aptean Food and Beverage APIs

Article • 4/3/2023 • 2 min read

This topic describes the setup and initialization of Postman and the corresponding work instructions to test the released Aptean Food and Beverage APIs on your Business Central environment.

Prerequisites

  1. The latest version of the Postman app can be downloaded here.
    a. Postman account (free or Gmail) must be created.
    b. Set up Workspace for Debugging and manual testing.
    c. Team creation is not mandatory.

  2. Get app registration information to be able to authenticate by using OAuth against your Business Central Online environment or create one as described in the Microsoft documentation.
    a. Create an app registration using the instructions here.
    b. Set up the app registration using the instructions here.
    c. Start using OAuth in Postman API requests using the instructions here.


Save the ClientID, TenantID, and Secret for setup of the Postman environment variables as the next steps.

Import and configure Postman Environment

  1. Download the latest version of Postman Aptean BC Environment Variables here.
    a. Select Import and import the Aptean BC.postman_environment.json file.


    b. Select the Aptean BC environment. Click the Environment quick look icon and then click Edit to set the current values for variables.


    c. Set your Domain or TenantID and your Environment name to be used as the current value for the URL.
    d. To be able to use the OAuth Authorization, set the earlier saved TenantID, ClientID, and Secret of the app registration in the Postman Environment variables.


For all example requests, these will now be used as the default values to authorize by using OAuth.

Using the Get New Access Token button, the Bearer Token should become available to be used in your requests.

Import Postman Requests Collection

  1. Download the latest version of the Postman Aptean Packaging Requests Collection here.
    a. Import again and import the Aptean Packaging.postman_collection.json file. Open Collections to find all provided requests.

  2. Initialize your environment variables by running the GET Requests.
    a. Initialize Companies Environment Variables


Make sure to get a (new) Bearer Token for authentication as described in the previous steps to be able to send requests.

  1. Now you can test all provided requests and see the response messages.