Backend APIsEndpoints
Endpoints Overview
Complete Cookest API endpoint reference
Endpoints Overview
Cookest now exposes two Rust backend services:
- the Food API on port
8081for catalog data - the App API on port
8080for authenticated app workflows
All endpoints return JSON unless noted otherwise.
Base URL
http://localhost:8080 (App API)
http://localhost:8081 (Food API)Authentication
App API protected endpoints require:
Authorization: Bearer <access_token>Subscription-gated App API endpoints return 402 when accessed by a Free user:
{ "error": "subscription_required", "feature": "user_recipes" }Endpoint groups
| Group | Path prefix | Auth required |
|---|---|---|
| Food API | /api/v1/ingredients, /api/v1/recipes | Public reads / API key writes |
| Auth | /api/auth | Varies |
| Profile & Preferences | /api/me | JWT |
| Recipes | /api/recipes | Varies |
| Image Generation | /api/image-gen | JWT |
| Meal Plans | /api/meal-plans | JWT |
| Inventory | /api/inventory | JWT |
| Shopping List | /api/shopping-list | JWT |
| Subscription | /api/subscription | JWT |
| Stores & Promotions | /api/stores, /api/admin | Varies |
| AI Chat | /api/chat | JWT |
Subscription tiers
| Feature | Free | Pro €9.99/mo | Family €14.99/mo |
|---|---|---|---|
| Inventory + basic meal plan | ✓ | ✓ | ✓ |
| AI-scored meal plan generation | — | ✓ | ✓ |
| AI Chat | 10/day | Unlimited | Unlimited |
| Price comparison | — | ✓ | ✓ |
| Create recipes | — | ✓ | ✓ |
| Shopping list optimizer | — | ✓ | ✓ |
| Multiple household profiles | — | — | ✓ |