OpenAPI 3.1 & Middleware Portal

1. Architektur-Prinzipien & Edge Inferenz

Im Gegensatz zu herkömmlichen Cloud-KI-Lösungen (OpenAI, AWS Lex) operieren unsere Engines nach dem Zero-Trust- und Zero-Leakage-Paradigma:

01 // AUDITSICHERHEIT

Flüchtige RAM-Inferenz

Audiosignale werden ausschließlich im flüchtigen Arbeitsspeicher (RAM) der lokalen Edge-Hardware gehalten. Null Speicherung von Roh-Audiodateien, keine biometrischen Stimmprofile.

02 // DETERMINISMUS

Strikte Schema-Validierung

Jede Extraktion wird gegen formale Pydantic- und JSON-Schemas validiert (SIS Pflege-Themenfelder, VOB/B Bautagesberichte, GAEB XML X83).

03 // FUNKLOCH-ROBUST

100% Offline-Fähigkeit

Läuft lokal auf Apple Neural Engine, Snapdragon NPU oder On-Premises Servern. Keine Abhängigkeit von Internetverbindung oder externen Cloud-APIs.

2. Authentifizierung & Edge License Token

Alle API-Aufrufe an den lokalen Edge-Daemon oder das Gateway erfordern ein kryptografisch verifiziertes License-Token im Header:

HTTP HEADER SCHEMA

Authorization: Bearer syn_edge_sec_994819481029481029
X-Synapse-Client: Synapse-Core-SDK/2.4.0 (macOS-arm64)
X-Edge-Device-ID: EDGE-BS-CARE-NODE-04

3. HealthTech & Pflege: SIS Assessment Ingestion

Mappt gesprochene Pflege-Beobachtungen in strukturierte SIS-Themenfelder (1–6), extrahiert Vitalwerte und generiert HL7/FHIR R4 Observation-Ressourcen.

POST /v1/voice2x/care/assessments/sis

100% DSGVO Art. 9 Konform // SIS Standard

Parameter	In	Typ	Beschreibung
audio*	formData	File (WAV/M4A)	16kHz PCM Audiosignal aus dem Patientenzimmer.
patient_id*	formData	string	Pseudonymisierte Patienten-Kennung (z.B. `P-8821-MUELLER`).
schema	formData	string	Standard: `SIS_GERMAN_CARE_STANDARD`.

⚡ INTERAKTIVER TEST-CONSOLE (TRY IT OUT)

SIMULIERTES SPRACHMEMO (AUDIO TRANSCRIPTION INPUT):

HTTP 200 OK Latenz: 142 ms (Edge-RAM)

{
  "status": "success",
  "engine_version": "Voice2x_Care_SIS_v2.4",
  "patient_id": "P-8821-MUELLER",
  "sis_assessment": {
    "themenfeld": 2,
    "themenfeld_name": "Mobilitaet_und_Beweglichkeit",
    "beobachtung": "Herr Müller geht selbstständig mit Rollator im Flurbereich",
    "vitalparameter": {
      "trinkmenge_ml": 1200,
      "systole_mmhg": 128,
      "diastole_mmhg": 82
    },
    "risiko_screening": [
      {
        "risiko": "Dekubitus",
        "grad": "Frühzeichen Grad 1",
        "lokalisation": "Fersenbein rechts",
        "massnahme": "Druckentlastung & Wundprotokoll initiiert"
      }
    ],
    "fhir_r4_export": "HL7_FHIR_R4_OBSERVATION_VALIDATED"
  }
}

curl -X POST "https://api.synapse-delic.de/v1/voice2x/care/assessments/sis" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "audio=@patient_memo.wav" \
  -F "patient_id=P-8821-MUELLER" \
  -F "schema=SIS_GERMAN_CARE_STANDARD"

4. ConTech & LPH 8: Bautagebuch Smart Ingestion

Multilinguale Baustellen-Memos (Türkisch, Serbisch, Polnisch, Fachjargon) werden deterministisch in formale VOB/B-Bautagesberichte und Bedenkenanzeigen nach § 4 & § 6 VOB/B übersetzt.

POST /v1/voice2x/contech/bautagebuch

VOB/B § 4 Abs. 3 & § 6 Abs. 1 Ready

⚡ INTERAKTIVER TEST-CONSOLE (TRY IT OUT)

SIMULIERTES SPRACHMEMO (AUF DER BAUSTELLE):

HTTP 200 OK Latenz: 118 ms (Edge-RAM)

{
  "status": "success",
  "engine_version": "Voice2x_ConTech_LPH8_v3.1",
  "project_id": "PRJ-2026-WOB-NORD",
  "bautagebuch_entry": {
    "timestamp": "2026-08-29T14:15:00Z",
    "gewerk": "Trockenbau & Brandschutz",
    "ort": "Haus B, 2. OG, Achse 4-7",
    "anwesende_arbeiter": 6,
    "behinderung": {
      "status": "akut",
      "vob_b_paragraph": "§ 6 Abs. 1 VOB/B",
      "ursache": "Fehlende Rohbau-Freigabe durch Vorunternehmer",
      "auswirkung_tage": 3,
      "rechtssichere_formulierung": "Bedenkenanzeige nach § 4 Abs. 3 VOB/B und Behinderungsanzeige nach § 6 Abs. 1 VOB/B formell generiert."
    }
  }
}

curl -X POST "https://api.synapse-delic.de/v1/voice2x/contech/bautagebuch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "audio=@baustelle_memo.wav" \
  -F "project_id=PRJ-2026-WOB-NORD" \
  -F "lph=8"

5. KalkuScan & LPH 6 Plananalyse

Extrahiert Wandflächen, Trockenbaumassen und Rohbaumaße aus PDF-Grundrissen und erzeugt ein annotiertes, visuell prüffähiges PDF sowie standardisierte GAEB XML (X83) Exportdateien.

POST /v1/interface2x/kalkuscan/analyze-plan

GAEB XML X83 & Bluebeam Annotated PDF

CURL REQUEST

curl -X POST "https://api.synapse-delic.de/v1/interface2x/kalkuscan/analyze-plan" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "pdf=@grundriss_ug_a1.pdf" \
  -F "scale=1:50" \
  -F "generate_annotated_pdf=true"

6. ESG Twin: Handover Bridge & CAFM Sync

Schließt die ESG-Datenlücke beim Übergang von der Bauausführung (LPH 8) in die Bewirtschaftung. Synchronisiert Bauteildaten, U-Werte und EPDs direkt in SAP RE-FX, Yardi und Austen CAFM.

POST /v1/interface2x/esgtwin/sync

ZIA & ECORE Taxonomie Standard

JSON PAYLOAD

curl -X POST "https://api.synapse-delic.de/v1/interface2x/esgtwin/sync" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "asset_id": "DE-BS-2026-OFFICE-NORTH",
    "handover_batch": 4,
    "verify_esg_taxonomy": true
  }'

7. Doozer REST Interface Integration (OpenAPI 2.0 Bridge)

Doozer Real Estate Systems stellt eine standardisierte REST-Schnittstelle unter https://app.doozer.de/openapi/ bereit (Auth via X-API-Key). Voice-2-x fungiert als vorgeschalteter intelligenter Adapter, der gesprochene Memos ohne Anpassung an Doozer direkt in native Doozer-Entitäten mappt:

POST /v1/bridge/doozer/orders/{order_id}/defects

Multilingual Tenant Damage Report ➔ Doozer Ticket

Spoken Input (Türkisch): „Mutfaktaki lavabonun altından su damlıyor, boru patlamış gibi, dolap ıslandı.“

NATIVE DOOZER PAYLOAD (MAPPED IN 780ms)

{
  "order_id": "DOOZER-ORD-88412",
  "defect_type": "Wasserschaden / Rohrleitung",
  "category": "Sanitär & Heizung",
  "room": "Küche",
  "urgency": "HIGH",
  "description": "Wasser tropft unter der Küchenspüle hervor, vermuteter Rohrbruch. Spülenunterschrank durchnässt. (Automatisch übersetzt aus dem Türkischen)",
  "source": "SYNAPSE_VOICE_FEEDER",
  "detected_language": "tr",
  "confidence_score": 0.98,
  "suggested_trade": "Sanitär- und Heizungstechnik",
  "status": "OPEN",
  "reported_at": "2026-08-29T10:30:00Z"
}

PUT /v1/bridge/doozer/orders/{order_id}/milestones

Craftsman Zero-UI Feeder ➔ Doozer Milestone Update

Spoken Input (Handwerker auf Baustelle): „Estrich im 2. OG fertiggestellt, Fliesenleger startet wegen Material erst Montag.“

DOOZER MILESTONE PAYLOAD (100% OFFLINE EDGE PROCESSED)

{
  "order_id": "DOOZER-ORD-88412",
  "milestone_updates": [
    {
      "trade": "Estrichleger",
      "status": "COMPLETED",
      "notes": "Estrich im 2. OG vollständig eingebracht"
    },
    {
      "trade": "Fliesenleger",
      "status": "DELAYED",
      "planned_start": "2026-08-31",
      "delay_reason": "Materialengpass",
      "vob_obstruction_flag": true
    }
  ]
}

8. Status & Fehlercodes (RFC 7807 Problem Details)

Alle Fehlerantworten folgen dem standardisierten RFC 7807 Problem-Details-Format:

Code	Status	Bedeutung & Handlungsempfehlung
200	OK	Erfolgreich im flüchtigen RAM verarbeitet und strukturiert.
400	Bad Request	Ungültiger Audio-Stream oder fehlende Pflichtparameter.
401	Unauthorized	Fehlender oder abgelaufener Edge-API-Key.
422	Unprocessable Audio	Audio-Signal enthält keine verständliche Sprache / extremes Störgeräusch (> 95 dB).
503	Edge Buffer Active	Lokaler Edge-Knoten im Offline-Sync-Modus. Daten im sicheren lokalen Puffer.

9. Offizielles TypeScript SDK

Vollständig typisierte Client-Bibliothek für Node.js, Electron und React-Webapplikationen:

TYPESCRIPT CLIENT

import { Voice2xCareClient } from '@synapse-delic/sdk-care';

const client = new Voice2xCareClient({
  endpoint: 'http://localhost:8080/v1',
  edgeMode: true // 100% lokale RAM-Inferenz
});

const result = await client.parseSISAssessment({
  patientId: 'P-8821-MUELLER',
  audioBuffer: fs.readFileSync('memo.wav'),
  schema: 'SIS_GERMAN_CARE_STANDARD'
});

console.log('SIS Payload:', result.sis_assessment);

10. Offizieller Python API Client

Asynchroner Client mit nativer Pydantic-Schema-Validierung für Datenpipelines und ERP-Bridges:

PYTHON CLIENT

from synapse_sdk import Voice2xClient

client = Voice2xClient(
    api_key="syn_edge_sec_994819481029481029",
    local_edge_endpoint="http://127.0.0.1:8080/v1"
)

with open("baustelle_memo.wav", "rb") as f:
    report = client.contech.create_bautagebuch_entry(
        audio=f.read(),
        project_id="PRJ-2026-WOB-NORD",
        lph=8,
        auto_vob_compliance=True
    )

print(f"Gewerk: {report.bautagebuch_entry.gewerk}")
print(f"VOB-Behinderung: {report.bautagebuch_entry.behinderung.rechtssichere_formulierung}")

11. DSGVO Art. 9 & NIS-2 Audit-Zertifizierung

Vergleich der Sicherheitsarchitektur von Synapse Delić Edge-Engines gegenüber herkömmlichen Cloud-KI-Lösungen:

Kriterium	Synapse Delić Edge-Engines	Herkömmliche Cloud-APIs
Datenhaltung	100 % lokaler RAM (flüchtig) — 0 Byte Cloud-Speicherung	Cloud-Server (meist US-Rechenzentren / AWS / Azure)
DSGVO Art. 9 (Gesundheitsdaten)	Vollständig konform ohne Drittlandtransfer	Erfordert komplexe AVVs, oft Verbot durch DSB
Betriebsrat § 87 BetrVG	Keine Stimmprofile, keine Mitarbeiterüberwachung	Stimmen-Persistenz erfordert monatelange Freigaben
Offline-Verfügbarkeit	Funktioniert im Keller und Funkloch ohne Einschränkung	Totalausfall bei fehlender Internetverbindung
Lizenzmodell	CapEx (Einmalkauf) & 100% Software-Ownership	Dauerhafte monatliche Abonnements (Seat-Pricing)

Voice-2-x & Interface-2-x OpenAPI Spezifikation