> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pachtify360.de/llms.txt
> Use this file to discover all available pages before exploring further.

# API verwenden

> OpenAPI, Basisadresse und Grenzen der automatisch erzeugten Referenz.

Die Express-API ist unter dem Präfix **`/api`** erreichbar.
Die API-Referenz wird aus der zentralen Spezifikation
`lib/api-spec/openapi.yaml` und den im Hauptrouter eingebundenen Routen erzeugt.
Die Dokumentationskopie steht als [OpenAPI-Datei](/openapi.yaml) bereit.

## Zwei Dokumentationstiefen

* **Vertraglich beschrieben:** Operationen aus der zentralen OpenAPI-Datei
  übernehmen deren Parameter und Datenschemata.
* **Route erfasst:** Zusätzliche implementierte Operationen sind ausdrücklich
  mit `x-documentation-status: route-only` gekennzeichnet. Methoden und Pfade
  sind bekannt; vollständige Anfragen-/Antwortschemata sind dort noch nicht
  zentral definiert. Ein generischer Antwortblock ist keine Zusicherung
  bestimmter Felder oder erfolgreicher Verarbeitung.

Die [Routenübersicht](/api/routen) zeigt die Zuordnung und Quelldatei.
Dieser Abgleich ist statisch; er führt keine API-Anfragen aus.

<Warning>
  Die Dokumentation ist kein Freibrief für schreibende API-Aufrufe.
  Der Mintlify-Spielplatz ist absichtlich deaktiviert. Das schützt insbesondere
  Buchungen, Importe, Löschfunktionen und sevDesk-Übertragungen vor
  versehentlichen Testaufrufen aus der Dokumentation.
</Warning>

## Beispiele

`PACHTIFY_BASE_URL` bezeichnet in Beispielen deine tatsächliche
Installationsadresse, nicht die Dokumentationsdomain:

```bash theme={null}
curl --fail "$PACHTIFY_BASE_URL/api/healthz"
```

Der Healthcheck antwortet mit `{"status":"ok"}`.
Geschützte Endpunkte erfordern eine gültige Anwendungssitzung.
Es wird kein zusätzlicher allgemeiner Bearer-API-Key erfunden oder angeboten.

## Datums- und Geldwerte

Termine werden als Kalenderdatum `YYYY-MM-DD` verwendet.
Vermeide Zeitzonenverschiebungen bei der Umwandlung in JavaScript-`Date`.
Die Geldberechnung verwendet Centwerte; formatiere angezeigte Eurobeträge
nicht erneut als Grundlage für eine eigene Gleitkomma-Nachberechnung.

Listen können Filter und Pagination verwenden. Nutze die je Operation
beschriebenen Parameter und eine serverseitige Suche für große Objektmengen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.