Master Insomnia: A Lightweight Open‑Source API Client for Backend Developers

Insomnia Overview

Insomnia is an open‑source, cross‑platform API client that supports GraphQL, REST, WebSockets, and gRPC, and has earned over

29K

stars on GitHub.

Installation

Download the installer from the official website https://insomnia.rest/download and run the package; the setup is straightforward.

Usage

We demonstrate debugging the mall e‑commerce project (a SpringBoot + Vue + uni‑app system) using Insomnia. The project’s repository is https://github.com/macrozheng/mall and has 60K stars.

Open Insomnia and create a new workspace.

Start the mall project and open its Swagger UI at

http://localhost:8080/swagger-ui/

.

Import the Swagger URL into Insomnia; the endpoints appear as a collection.

Set the environment variables (use Swagger’s defaults) and clear

base_path

.

Adjust the

Authorization

header as needed; remove it for unauthenticated endpoints such as login.

For authenticated endpoints, add an

api_key

variable with the token obtained from the login API.

Fill request parameters; Insomnia auto‑populates the format, making testing convenient.

Settings

Insomnia offers customizable settings such as font size and theme selection, with up to 18 built‑in themes.

Change the font size via the settings button at the lower left.

Switch themes in the settings panel to suit personal preferences.

Conclusion

Insomnia provides a sleek, powerful, and lightweight alternative to Postman; its simplicity and visual appeal make it an excellent choice for developers who need an efficient API testing tool.