API-Referenz¶

Für interaktive API-Docs mit laufendem Backend:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

Print & Export (REQ-032)¶

Alle Print-Endpunkte liegen unter dem mandantenspezifischen Pfad /api/v1/t/{slug}/print/ und erfordern ein gültiges JWT-Token. Die Zugriffsrechte entsprechen den Berechtigungen der zugrundeliegenden Daten (REQ-024 RBAC) — wer einen Nährstoffplan lesen darf, darf ihn auch drucken.

Gemeinsame Query-Parameter (alle Endpunkte):

Nährstoffplan-PDF¶

Exportiert einen vollständigen Nährstoffplan als PDF inklusive Phasen-Tabelle, Mischanleitungen, Wasser-Konfiguration und CalMag/Flushing-Hinweisen.

GET /api/v1/t/{slug}/print/nutrient-plan/{plan_key}

Pfad-Parameter:

Response: application/pdf mit Content-Disposition: attachment; filename="naehrstoffplan-{plan_key}.pdf"

Beispiel:

curl -X GET \
  "https://api.example.com/api/v1/t/mein-garten/print/nutrient-plan/nutrient_plans/42?locale=de" \
  -H "Authorization: Bearer <token>" \
  --output naehrstoffplan.pdf

Pflege-Checkliste-PDF¶

Exportiert alle fälligen Pflegeaufgaben für ein bestimmtes Datum als Checkliste mit Checkboxen, gruppiert nach Dringlichkeit (überfällig, heute fällig, demnächst).

GET /api/v1/t/{slug}/print/care-checklist

Query-Parameter (zusätzlich zu locale und format):

Response: application/pdf mit Content-Disposition: attachment; filename="pflege-checkliste-{date}.pdf"

Beispiel:

curl -X GET \
  "https://api.example.com/api/v1/t/mein-garten/print/care-checklist?date=2026-04-15&locale=de" \
  -H "Authorization: Bearer <token>" \
  --output pflege-checkliste.pdf

Pflanzen-Infokarten / Etiketten-PDF¶

Druckt kompakte Infokarten mit QR-Code für eine oder mehrere Pflanzinstanzen. Der QR-Code enthält die Deep-Link-URL zur jeweiligen Pflanze in der App.

GET /api/v1/t/{slug}/print/plant-labels

Query-Parameter (zusätzlich zu locale):

Mögliche Werte für fields:

name, scientific_name, family, planted_date, current_phase, location, cultivar, note

Der QR-Code ist immer enthalten und kann nicht über fields abgewählt werden.

Response: application/pdf mit Content-Disposition: attachment; filename="pflanzen-etiketten.pdf"

Beispiel — 8 Karten pro A4-Seite mit Pflanzenname, wissenschaftlichem Namen und Pflanzdatum:

curl -X GET \
  "https://api.example.com/api/v1/t/mein-garten/print/plant-labels\
?plant_keys=plant_instances/101,plant_instances/102,plant_instances/103\
&fields=name,scientific_name,planted_date,location\
&layout=grid_2x4\
&qr_size_mm=25\
&locale=de" \
  -H "Authorization: Bearer <token>" \
  --output etiketten.pdf

Fehlercodes:

Verfügbare Templates auflisten¶

Gibt eine Liste aller registrierten Print-Templates zurück.

GET /api/v1/print/templates

Dieser Endpunkt ist nicht mandantenspezifisch und erfordert lediglich eine gültige Authentifizierung.

Response-Beispiel:

[
  {
    "type": "nutrient_plan",
    "label_de": "Nährstoffplan",
    "label_en": "Nutrient Plan",
    "formats": ["pdf"],
    "locales": ["de", "en"]
  },
  {
    "type": "care_checklist",
    "label_de": "Pflege-Checkliste",
    "label_en": "Care Checklist",
    "formats": ["pdf"],
    "locales": ["de", "en"]
  },
  {
    "type": "plant_label",
    "label_de": "Pflanzen-Infokarte",
    "label_en": "Plant Info Card",
    "formats": ["pdf"],
    "locales": ["de", "en"]
  }
]

Siehe auch¶

• Druckansichten & Export — Benutzerhandbuch
• Dünge-Logik
• Pflegeerinnerungen