☄️Sending your first API request

Sending your first API request

Postman enables you to create and send API requests. Send a request to an endpoint, retrieve data from a data source, or test an API's functionality. You don't need to enter commands in a terminal or write any code. Create a new request and select Send, and the API response appears right inside Postman.

API requests defined

APIs provide a structured way for one application to access the capabilities of another application. Typically, this communication happens over the internet by way of an API server. A client application (like a mobile app) sends a request to the server, and after the request processes the server returns a response to the client.

A request includes the URL of the API endpoint and an HTTP request method. The method indicates the action you want the API to perform. Here are some of the most common methods:

• GET retrieves data from an API.

• POST sends new data to an API.

• PATCH and PUT update existing data.

• DELETE removes existing data.

Sending an API request

When you're ready, open Postman and send your first API request.

1. Select + in the workbench to open a new tab.

2. Enter postman-echo.com/get for the request URL.

3. Select Send.

Postman displays the response data sent from the server in the lower pane.

What happened?

In this example, Postman is acting as the client application and is communicating with an API server. Here's what happened when you selected Send:

1. Postman sent a GET request to the Postman Echo API server located at postman-echo.com.

2. The API server received the request, processed it, and returned a response to Postman.

3. Postman received the response and displayed it in the Response pane.

You used Postman to send an API request and got a response from the API server. It's okay to take a moment to sit back and reflect on how cool that is!