TrailForge public API
The mobile app and three retail partners call these endpoints. This is the surface API Discovery would inventory automatically.
| Method | Path | Purpose | Cache | |
|---|---|---|---|---|
| GET | /api/products |
Full catalog, supports ?category= and ?sort= | cacheable | |
| GET | /api/products/:sku |
Single product record | cacheable | |
| GET | /api/categories |
Category taxonomy | cacheable | |
| GET | /api/inventory/:sku |
Real-time stock for one SKU | no-store | |
| GET | /api/search?q= |
Catalog search | no-store | |
| POST | /api/login |
Customer authentication | no-store | |
| GET | /api/cart |
Current cart count and lines (fills the header badge on cached pages) | no-store | |
| POST | /api/cart |
Add an item to the cart | no-store | |
| DELETE | /api/cart/:sku |
Remove a line from the cart | no-store | |
| POST | /api/checkout |
Submit payment and create an order | no-store | |
| GET | /api/orders/:id |
Order detail, session scoped | no-store | |
| GET | /api/stats |
Origin load counters powering the ops console | no-store | |
| GET | /api/health |
Origin health probe | no-store |
Response
Pick an endpoint and press Try.