Setting Up Postman

Postman is the most popular API testing tool - used by over 25 million developers. Let's get it set up.

Installing Postman

Option 1: Desktop App (Recommended)

• Go to [postman.com/downloads](https://www.postman.com/downloads/)
• Download for your OS (Windows, Mac, or Linux)
• Install and launch

Option 2: Web Version

Visit [web.postman.co](https://web.postman.co) to use Postman in your browser.

> Tip: The desktop app is better for testing local APIs (localhost).

---

Creating an Account

While optional, a free account lets you:

• Sync collections across devices
• Collaborate with team members
• Access cloud features

Click Sign Up and create an account with email or Google.

---

The Postman Interface

Let's understand the key areas:

┌─────────────────────────────────────────────────────────────────┐
│  [New] [Import]                              [Workspaces ▼]     │
├──────────────┬──────────────────────────────────────────────────┤
│              │  ┌─────────────────────────────────────────────┐ │
│  Collections │  │ GET ▼ │ https://api.example.com/products   │ │
│              │  └─────────────────────────────────────────────┘ │
│  ○ My Shop   │                                                  │
│    └ Products│  Params  Auth  Headers  Body  Pre-req  Tests    │
│    └ Cart    │  ──────────────────────────────────────────────  │
│    └ Orders  │                                                  │
│              │                                                  │
│  Environments│  ─────────────────────────────────────────────── │
│  ○ Dev       │  Response                                        │
│  ○ Staging   │  Body  Cookies  Headers  Test Results           │
│  ○ Prod      │                                                  │
│              │  { "products": [...] }                           │
└──────────────┴──────────────────────────────────────────────────┘

Key Areas:

---

Creating Your First Workspace

Workspaces help organize your API testing projects.

• Click Workspaces in the header
• Click Create Workspace
• Name it: E-commerce API Testing
• Choose Personal (or Team if collaborating)
• Click Create

---

Creating a Collection

Collections group related API requests together.

• In the sidebar, click + next to Collections
• Name it: Shop API
• Add a description: API tests for our e-commerce platform

Your collection structure will look like:

📁 Shop API
  📁 Products
     GET List Products
     GET Get Product by ID
     GET Search Products
  📁 Cart
     GET View Cart
     POST Add to Cart
     DELETE Remove from Cart
  📁 Orders
     POST Create Order
     GET Get Order Status

---

Quick Settings to Configure

1. SSL Certificate Verification

For local development (localhost), you might need to disable SSL verification:

> Only disable for local testing, never for production APIs!

2. Request Timeout

Default is 0 (infinite). Set a reasonable timeout:

3. Auto-save

Enable auto-save to never lose your work:

---

Testing Your Setup

Let's verify Postman is working with a simple public API:

• Click + to open a new request tab
• Enter this URL: https://jsonplaceholder.typicode.com/posts/1
• Make sure GET is selected
• Click Send

You should see:

{
  "userId": 1,
  "id": 1,
  "title": "sunt aut facere repellat provident occaecati excepturi",
  "body": "quia et suscipit\nsuscipit recusandae..."
}

• Status: 200 OK ✅
• Time: Should be under 1 second
• Size: Shows response size in bytes

---

Keyboard Shortcuts

Speed up your workflow:

---

Practice: Create Your Structure

Set up folders for our e-commerce API testing:

• Create Collection: Shop API
• Add Folders:

- Cart

- Orders

- Users

Right-click collection → Add Folder

Your sidebar should look like:

📁 Shop API
  📁 Products
  📁 Cart
  📁 Orders
  📁 Users

---

Key Takeaways

• Postman is available as desktop app or web version
• Workspaces organize your projects
• Collections group related API requests
• Folders within collections keep things tidy
• Learn keyboard shortcuts to work faster

Next up: Your First API Request - let's send some real requests!