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.