Für Entwickler

Vermerk Core API

Vermerk ist API-first. Dieselben Endpunkte, die die Vermerk-App und das Web-Dashboard verwenden, stehen Ihnen für eigene Integrationen offen — etwa zur Anbindung an DATEV, Ihr Dokumentenmanagement oder Kanzlei-Workflows. REST · JSON · OpenAPI 3 · gehostet in Deutschland.

Basis-URL
https://api.vermerk.eu
Auth
Bearer-Token (API-Schlüssel) Authorization: Bearer mai_live_…
Format
JSON · OpenAPI 3
Hosting
Hetzner Deutschland · DSGVO Art. 28

Dokumentation

Die Spezifikation wird direkt aus der laufenden API generiert und ist immer aktuell. Drei Formate:

Swagger UI
Interaktiv

Endpunkte direkt im Browser ausprobieren, Bearer-Token einsetzen, Antworten betrachten.

/v1/docs
ReDoc
Lesbar

Schmale, gut lesbare Referenz aller Ressourcen mit Beispielen — ideal zum Querlesen.

/v1/redoc
OpenAPI JSON
Maschinell

Vollständiges OpenAPI-3-Schema zum Generieren von Clients (TypeScript, Python, Go, …).

/v1/openapi.json

Erste Schritte

  1. 1. Workspace anlegen. Wenn Sie noch keinen haben, registrieren Sie sich kostenlos oder wählen Sie einen Tarif.
  2. 2. API-Schlüssel erzeugen. Im Web-Dashboard unter https://app.vermerk.eu/app/api-keys einen Schlüssel benennen. Der Geheimteil wird einmalig angezeigt — danach nur noch prefix•••suffix.
  3. 3. Erste Anfrage senden. Zum Beispiel: Liste der eigenen Aufnahmen abrufen:
curl -H "Authorization: Bearer mai_live_…" \
  https://api.vermerk.eu/v1/recordings

Eine vollständige Recording-Pipeline (Upload → Transkript → Zusammenfassung → Export) ist in der Swagger-UI in unter fünf Minuten durchspielbar.

Authentifizierung

Jede Anfrage trägt einen Bearer-Token im Authorization-Header. Zwei Token-Typen werden akzeptiert:

  • API-Schlüssel (mai_live_<tenant>_<secret>) — für Server-zu-Server-Integrationen. Im Dashboard erzeugt und widerrufbar.
  • JWT (1 Stunde gültig) — für interaktive Sessions des Web-Dashboards und der Desktop-App.

Rate-Limits gelten pro IP und pro Token. Beim Überschreiten antwortet die API mit HTTP 429 und einem Retry-After-Header.

Support

Fragen, fehlende Endpunkte oder ungewöhnliches Verhalten? Schreiben Sie an kontakt@vermerk.eu. Wir antworten in der Regel innerhalb eines Werktags.

Eine Übersicht aller eingesetzten Auftragsverarbeiter finden Sie auf der Seite Subprozessoren.