# Postman Collection

# Introduction

Since we're dealing with APIs, you may have heard of Postman, a popular API development tool that allows you to test, document, and share APIs quickly and easily. One of the key features of Postman is the ability to create and share API collections, which are groups of requests that can be organized and executed together as a single unit. In this article, we'll explain how to download, install & use Ristecho APIs Collection and add it to your Postman.

# Download and Install the collection

Please click on this link to download the collection Once you have downloaded the API Postman collection file, you can import it into Postman by following these steps:

1. Open Postman and click on the "Import" button in the top left corner of the window.
2. Select the "Import File" tab, and then click on the "Choose Files" button.
3. Navigate to the location where you saved the API Postman collection file, and select it.
4. Click on the "Import" button to import the collection into Postman.

# How to use the collection

After you have imported the Ristecho API collection into your Postman, you can use it to test the APIs by following these steps:

1. First, you need to create an environment in order to configure the dynamic variables values for the collection following the below steps:

   • Open Postman and click on the gear icon in the top right corner of the window.
   • Click on "Manage Environments".
   • Click on the "Add" button to create a new environment.
   • Enter a name for the environment and add our variables and values as shared from the integration team. Collection Variable Names: baseURL & token.
   • Click on the "Add" button to create the environment.
   • Select the environment from the dropdown menu in the top right corner of the window to use it to start consuming Ristecho APIs.

2. Then, open the collection in Postman by clicking on it in the left sidebar.

3. Click on the "Send" button next to one of the requests to send the request to the API.

4. View the response from the API in the "Response" tab, and use the other tabs to view the request details, parameters, headers, and other settings.

5. You can explore required endpoints, possible filters, sorting, and includables for each endpoint by looking into the request Parameters.