Step 2 - Getting Started with Postman
5 min
overview in this document, you will learn how to use postman to make requests to the zen master api we will cover these topics download the api definition import the api definition set collection variables send a get request for sources as an api user, you will have admin access in zen master, allowing you to view objects and update all settings available to administrators download the api definition you can download a copy of the zen master api definition in both yaml and json format either format will work in postman login to the zixi customer portal in the left navigation, select documentation select the by type tab, and then select zen master api to download the json file open the zen master api html reference at the top of the api reference, click the download button a json file will be downloaded to your computer to download the yaml file in the zixi customer portal, locate the zen master api yaml file click the download button a zipped yaml file will be downloaded to your computer import the api definition in postman, you can import an api definition using either the yaml or the json format in a web browser, navigate to https //www postman com/ https //www postman com/ sign in or create an account in the left sidebar, click import select your copy of either the yaml or the json api definition file choose to import the definition as a collection and click import set collection variables next, you will provide values for the zen master api collection variables return to the postman ui in the left sidebar, select the zixi zen master api collection, and then select variables here, you’ll define collection variables for base url and api key for the baseurl variable, enter the zen master api base url https //api zen zixi com/v2 https //api zen zixi com/v2 next, create a variable named apikey if you don’t already have a zen master api authentication key, see the getting started with authentication document paste the zen master api key value that you created in the zixi zen master dashboard paste the same value into the initial value and the current value fields click save your variables are ready to use with any request within the collection send a get request for sources next, you are ready to send a request to the zen master api return to postman in the left sidebar, select the zixi zen master api collection, and expand the sources folder select get list sources for the get url endpoint, remove all of the query parameters click send you should see response data with an array of sources for a complete list of request paths, see the zixi zen master api reference