# Tandoor API Reference

Interacts with the personal Tandoor instance at `https://rezept.papst.beer`.

## Connection

- **Server:** `https://rezept.papst.beer`
- **API Key:** in `~/.claude/.secrets` (Line 2, Format `tda_...`)
- **API Spec:** `~/.claude/docs/Tandoor (2.6.6).yaml`
- **Auth-Header:** `Authorization: Bearer <KEY>`

## Endpoints

| Resource        | Endpoint                        | Methods                    |
|-----------------|---------------------------------|-----------------------------|
| Recipes         | `/api/recipe/`                  | GET, POST                   |
| Recipe Detail   | `/api/recipe/{id}/`             | GET, PUT, PATCH, DELETE     |
| Food            | `/api/food/`                    | GET, POST                   |
| Units           | `/api/unit/`                    | GET, POST                   |
| Eigenschaften   | `/api/property-type/`           | GET, POST                   |
| Keywords/Tags   | `/api/keyword/`                 | GET, POST                   |
| Meal Plan       | `/api/meal-plan/`               | GET, POST                   |
| Shopping Lists  | `/api/shopping-list/`           | GET, POST                   |
| Books           | `/api/book/`                    | GET, POST                   |
| Cook Log        | `/api/cook-log/`                | GET, POST                   |

All endpoints support pagination: `?page=1&page_size=50`

## Common Filters

- Recipes by name: `/api/recipe/?query=Suppe`
- Recipes by keyword: `/api/recipe/?keywords=5`
- Food search: `/api/food/?query=Knoblauch`