Quick Start Guide

This guide will help you start testing APIs in minutes. Let's focus on the essential steps to make your first API request.

Installation

Chrome

1. Visit the Chrome Web Store
2. Click "Add to Chrome"
3. Confirm the installation
4. Find the Boomerang icon in your browser's toolbar

Edge

1. Visit Microsoft Edge Add-ons
2. Click "Get"
3. Confirm the installation
4. Look for the Boomerang icon in your toolbar

Making Your First Request

Let's test a simple API endpoint:

1. Click the Boomerang icon to open the app
2. Enter this URL in the address bar:

   https://jsonplaceholder.typicode.com/posts/1

3. Ensure GET is selected as the method
4. Click the blue SEND button

TIP

You should see a JSON response appear with post data. Congratulations! You've just made your first API request.

Essential Features

Adding Query Parameters

There are two ways to add query parameters to your request:

Option 1: Directly in the URL

https://api.example.com/data?key=value&page=1

Option 2: Using the PARAMS tab

1. Click the PARAMS tab
2. Click "Add Param"
3. Enter parameter name (e.g., "key")
4. Enter parameter value (e.g., "value")
5. The URL will automatically update with your parameters

TIP

Both methods achieve the same result - use whichever you find more convenient!

Working with Headers

1. Click the HEADERS tab
2. Click "Add Header"
3. Enter header name and value
4. Enable/disable headers using checkboxes

Authentication

There are two ways to add authentication to your requests:

Basic Authentication

1. Click the AUTH tab
2. Select "Basic"
3. Enter username and password

Other Authentication Methods

Use the HEADERS tab to add appropriate authentication headers:

Bearer Token:
Authorization: Bearer your-token-here

API Key:
X-API-Key: your-api-key-here

Custom Auth:
Any-Auth-Header: your-auth-value

Common Gotchas & Solutions

No Response?

• If using the browser extension: Verify your URL and authentication details
• If using PWA: Check for CORS issues - you may need to use the browser extension to bypass CORS restrictions

Request not working?

Check your headers, especially Content-Type

Need to reuse data?

Create an environment and use variables