Postman Collection
Import-ready collection with all 98 endpoints, environment variables, and organized request folders. One click to start testing.
Import the Collection
Download the file using the button above
Open Postman
Click Import (top-left) and drag the JSON file, or click Upload Files
The "GunSpec API v1" collection appears in your sidebar
Configure Your API Key
Click the collection name (GunSpec API v1) in the sidebar
Go to the Variables tab
Set api_key current value to test_key
Set base_url to http://localhost:8787
Click Save
Endpoints Included
| Folder | Endpoints |
|---|---|
| Health | Health Check, Ready Check |
| Firearms | List, Search, Compare, Get, Variants, Images, Game Stats, Users |
| Manufacturers | List, Get, Get Firearms |
| Calibers | List, Get, Get Firearms |
| Categories | List, Get Firearms |
Optional params: Disabled query parameters (manufacturer, caliber, category filters) can be enabled by unchecking "disabled" in the Params tab of each request.
Switching Environments
You can create Postman Environments to switch between local, staging, and production:
Click Environments in the sidebar, then +
Add base_url and api_key variables
Select the environment from the dropdown (top-right) before sending requests