Postman What Is an API
Before you open Postman, you need to understand what an API is. Postman is a tool built specifically to work with APIs. This topic explains APIs using a simple real-life picture so the idea sticks.
The Restaurant Diagram
Think of an API like a waiter at a restaurant.
- You (the customer) = the app or user who wants something
- The kitchen = the server or database that holds the data
- The waiter = the API
You tell the waiter what you want. The waiter goes to the kitchen, gets the food, and brings it back to you. You never go into the kitchen yourself. The API works the same way — it carries your request to the server and brings the response back to you.
What Does API Stand For
API stands for Application Programming Interface. The word "interface" means a connecting layer between two things. An API connects your app to another app or server.
A Real Example
When you check the weather on your phone, the weather app does not store weather data itself. It sends a request through a weather API to a weather server. The server sends back the current temperature, and the app shows it on your screen. The API is the invisible messenger that made this happen.
Why APIs Matter
APIs let different software systems talk to each other without sharing their internal code. A travel booking site uses APIs from airlines, hotels, and payment providers — all running separately but communicating through APIs. This saves developers from building everything from scratch.
Types of APIs You Will Use in Postman
REST API
REST (Representational State Transfer) is the most common type. It uses standard web addresses (URLs) to send and receive data. Postman works best with REST APIs.
SOAP API
SOAP (Simple Object Access Protocol) is an older format that uses XML. Some banks and enterprise systems still use SOAP.
GraphQL API
GraphQL lets you ask for exactly the data you need, nothing more and nothing less. Postman supports GraphQL requests too.
How an API Request Works – Step by Step
- Your app sends a request to a URL (called an endpoint)
- The request includes what you want to do — get data, send data, update something, or delete something
- The server receives the request and processes it
- The server sends back a response with data and a status code
- Your app reads the response and displays the result
Key Terms You Will See in Postman
| Term | What It Means |
|---|---|
| Endpoint | The URL address you send a request to |
| Request | The message you send to the server |
| Response | The reply you get back from the server |
| Status Code | A number that tells you if the request worked (200 = success, 404 = not found) |
| JSON | The most common format for API data (looks like key-value pairs) |
What JSON Looks Like
Most APIs return data in JSON format. Here is an example of what a weather API might return:
{
"city": "New York",
"temperature": "22",
"unit": "Celsius",
"condition": "Sunny"
}Each piece of information has a label (key) and a value. Postman displays this data in a readable format so you can inspect it easily.
Summary
An API is a messenger between apps. It takes your request, delivers it to a server, and brings the answer back. REST APIs are the most widely used, and Postman gives you a visual workspace to send requests and read responses without writing code.