# API-Referenz: Überblick

<Lead>
Diese Sektion beschreibt den programmatischen Zugang zur Plattform. Der aktuelle Stand in einem Satz: **Webhooks sind heute produktiv nutzbar**, die öffentliche **REST-API befindet sich in Vorbereitung** und erscheint mit dem Public Launch als vollständige OpenAPI-Referenz.
</Lead>

## Was heute verfügbar ist

<CardGrid>
  <Card title="Webhooks" href="/api/webhooks">
    Echtzeit-Events an deine Systeme: Event-Katalog, signierte Zustellungen nach Standard-Webhooks, Wiederholungen und Zustell-Log. Produktiv nutzbar.
  </Card>
  <Card title="Authentifizierung" href="/api/authentication">
    Das Auth-Modell der Plattform-API: API-Keys mit Geltungsbereichen. Aktuell als Beta-Fläche, Details zum geplanten Bearer-Schema.
  </Card>
  <Card title="Rate-Limits" href="/api/rate-limits">
    Die geplanten Limits pro Tarif und das heutige Verhalten bei zu vielen Anfragen.
  </Card>
  <Card title="Fehler-Codes" href="/api/errors">
    Das Fehlerformat der API: HTTP-Status-Codes, Fehler-Envelope und Umgang mit Wiederholungen.
  </Card>
</CardGrid>

## Status der REST-API

<BetaNotice>
Die öffentliche REST-API (Objekte, Kontakte, Zugangsdaten, Termine) ist für den Public Launch geplant. Die Endpoint-Referenz wird automatisch aus der OpenAPI-Spezifikation generiert und erscheint in dieser Sektion. Bis dahin gilt: Alles, was auf diesen Seiten als "geplant" markiert ist, kann sich noch ändern.
</BetaNotice>

Was das konkret bedeutet:

- **Webhooks** kannst du sofort einsetzen. Die Ereignisse, Signaturen und Wiederholungs-Regeln auf der [Webhook-Seite](/api/webhooks) sind der produktive Stand der Plattform.
- **API-Keys** existieren als Beta-Fläche unter **Einstellungen > API** in der Plattform. Der vollständige Key-Lebenszyklus (Erstellen mit Scope, einmalige Anzeige, Rotation, Logs) kommt zusammen mit der REST-API.
- **Endpoint-Dokumentation** (Pfade, Parameter, Schemas) folgt aus der OpenAPI-Spezifikation. Wir dokumentieren keine Endpoints, bevor sie stabil sind.

## Für wen ist diese Sektion?

Diese Seiten richten sich an Entwickler:innen, die die Plattform mit externen Systemen verbinden: CRM-Abgleich, Automatisierungs-Plattformen (Zapier, Make, n8n), eigene Skripte oder Backoffice-Integrationen. Wenn du stattdessen als Nutzer:in Hilfe zu einem Werkzeug suchst, ist die [Hilfe-Sektion](/help) der richtige Ort. Wenn du eigene Tools für den Marktplatz entwickeln willst, findest du die SDK-Dokumentation in der [Entwickler-Sektion](/dev).

## Häufige Fragen

<Faq>
  <FaqItem q="Kann ich heute schon Daten per REST abrufen?">
    Nein. Die öffentliche REST-API ist in Vorbereitung. Für Echtzeit-Anbindungen nutzt du heute Webhooks: Sie liefern bei jedem relevanten Ereignis die wichtigsten Daten direkt an dein System.
  </FaqItem>
  <FaqItem q="Wo verwalte ich Webhooks?">
    In der Plattform unter Einstellungen > Webhooks. Eine Schritt-für-Schritt-Anleitung findest du im Help-Center unter [Webhooks einrichten](/help/howto/webhooks); die technische Referenz steht auf der [Webhook-Seite](/api/webhooks) dieser Sektion.
  </FaqItem>
  <FaqItem q="Wann kommt die REST-API?">
    Mit dem Public Launch der Plattform. Die Referenz erscheint dann hier, generiert aus der OpenAPI-Spezifikation, zusammen mit einem Migrations-Leitfaden für frühe Integrationen.
  </FaqItem>
</Faq>