Public API · v1 (in Entwicklung)

Trygva Public API

REST-API fuer Hausverwaltungssoftware, Treuhaender, Steuerberater-Tools und ERP-Systeme. JSON-Payload, JWT-Auth, TypeScript-SDK, OpenAPI 3.1.

OpenAPI 3.1 herunterladen Vollstaendige Docs

Nur API-Updates. Wir senden 4-6 E-Mails pro Jahr.

Was die API kann

JWT-Authentifizierung

Bearer-Token in Authorization-Header. Refresh-Token-Rotation alle 30 Tage. Tenant-isoliert via PostgreSQL Row-Level Security.

TypeScript SDK

Typsicherer SDK-Client (trygva-client.ts) mit Fully-Typed-Endpoints + automatischem Retry. Auto-generierte Types aus OpenAPI-Spec.

Webhooks

Event-driven Notifications fuer termination.created, document.signed, mautic.contact.synced, payment.succeeded. Mit Signed-Payload-Verification.

N8N + Zapier Connectors

Pre-built Nodes / Actions fuer No-Code-Integrationen. Pflegt N8N-Workflow-Templates und Zapier-Apps.

Multi-Tenant

Pro Tenant separate Subdomain + isolierte Daten via PostgreSQL RLS. Bulk-Operations fuer Hausverwaltungen mit 100+ Einheiten.

OpenAPI 3.1

Machine-readable Spec fuer automatische Client-Generation, Postman-Import, Schema-Drift-Detection.

Kern-Endpoints

POST/api/v1/terminations

Neuen Kuendigungsfall starten — gibt Wizard-Session-Token zurueck.

curl -X POST https://api.trygva.ch/v1/terminations \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "ten_abc123",
    "country": "CH",
    "reason": "EIGENBEDARF",
    "tenantRecordId": "rec_xyz"
  }'

GET/api/v1/terminations/:id

Status eines Kuendigungsfalls abrufen — inkl. Risk-Score und TextGuard-Flags.

curl https://api.trygva.ch/v1/terminations/term_abc \
  -H "Authorization: Bearer $TOKEN"

POST/api/v1/textguard/scan

Frei-Text auf rechtliche Schwachstellen scannen (NLP).

curl -X POST https://api.trygva.ch/v1/textguard/scan \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Wir kuendigen Ihnen wegen Eigenbedarf...", "country": "CH" }'

POST/api/v1/calculators/raeumungsklage-kosten

Verfahrenskosten-Schaetzung fuer Raeumungsklagen — public, kein Auth.

curl -X POST https://api.trygva.ch/v1/calculators/raeumungsklage-kosten \
  -H "Content-Type: application/json" \
  -d '{ "country": "CH", "monthlyRent": 2000 }'

POST/api/v1/webhooks

Webhook-Subscription fuer Events. Bis zu 10 URLs pro Tenant.

curl -X POST https://api.trygva.ch/v1/webhooks \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-system.example.com/trygva-events",
    "events": ["termination.created", "document.signed"],
    "secret": "your-shared-secret"
  }'

Connectors fuer No-Code-Integrationen

N8NVerfuegbar

Self-hosted Workflow-Automatisierung. Pre-built Nodes fuer Termination, TextGuard, Webhooks.

ZapierBeta Q3 2026

Cloud-basierte No-Code-Verbindung zu 5'000+ Apps. Triggers + Actions.

MakeRoadmap

Visual-Workflow-Builder. Modul-basierter Zugriff auf alle Trygva-Endpoints.

Status: API v1 in Entwicklung

Die Public-API befindet sich aktuell in Entwicklung — Beta- Zugriff auf Anfrage, Public-Launch Q4 2026. Bis dahin koennen Hausverwaltungen, Treuhaender und Steuerberater den Trygva- Wizard direkt nutzen oder einen Beta-Zugang fuer ihren Anwendungsfall anfragen ( partners@trygva.ch).