Webhooks und adlass

miovea meldet Ereignisse einer Organisation an eigene Endpunkte und lässt sich als Werkzeugkasten in adlass einbinden. Gesundheitsdaten bleiben dabei in miovea: Ereignisse enthalten nur IDs und Status, Dokumente laufen über vorsignierte URLs direkt zwischen Agent und Speicher.

Ausgehende Webhooks

• Verwalten per Operation (webhooks.endpoints.create, .update, .delete, .rotate_secret, .test) oder in der App unter Einstellungen > KI-Zugriff > Webhooks; nur Admins. webhooks.events.list nennt die Ereignistypen.
• Signatur nach Standard Webhooks: Header webhook-id, webhook-timestamp, webhook-signature (v1,<base64 HMAC-SHA256> über {id}.{timestamp}.{body}, Schlüssel = base64-dekodierte Bytes hinter whsec_). Bei einer Secret-Rotation stehen 24 Stunden lang zwei Signaturen im Header.
• Body { type, timestamp, data }; data enthält org_id, die betroffene Objekt-ID sowie preinquiry_id, customer_id, customer_external_ref, preinquiry_external_ref, wo vorhanden. Keine Namen, keine Gesundheitsangaben, keine Dateinamen.
• Ereignisse: questionnaire.submitted, customer_link.document_uploaded, document.created, vote.received, inbox.message.matched, dispatch.delivered, dispatch.failed, preinquiry.status_changed, webhook.test.
• Zustellung mindestens einmal, 2xx innerhalb 10 Sekunden erwartet; Wiederholungen mit Backoff (höchstens 10 Versuche innerhalb von 72 Stunden, Retry-After innerhalb dieser Grenzen beachtet), danach wird der Endpunkt deaktiviert und der Vorgang steht im Verlauf. Anlegen, Ändern und Testen von Endpunkten unterliegen der Agenten-Richtlinie allow_external. 410 Gone deaktiviert sofort. Ziele müssen https und öffentlich erreichbar sein; private, lokale und Metadaten-Adressen sind gesperrt.
• Details, Prüfcode und Fehlerfälle: Guide webhooks (read_guide("webhooks"), GET /api/v1/operations/guides/webhooks).

Externe Referenzen

external_ref an Kunde und Vorgang verbindet miovea-Objekte mit Datensätzen eines anderen Systems: Format <authority>:<type>:<id> (z. B. ), höchstens 200 Zeichen, je Organisation eindeutig. und nehmen sie an, und filtern danach; eine Kollision antwortet mit und nennt bzw. . Trifft einen bestehenden Kunden ohne Referenz, übernimmt dieser die mitgegebene; genauso ein offener Vorgang bei .