labcomplete AIS-Schnittstelle - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Verbindung

Den Transport beschreibt das AsyncAPI-Dokument ais-socket-v1.asyncapi.yaml, lesbar im AsyncAPI Studio: Verbindung, Anmeldung, Schutz der Frames, Zustellung mit Quittung und Wiederholung, Grenzen.

• Endpunkt: wss://api.labcomplete.at/ais/v1/socket, Test: wss://api.test.labcomplete.at/ais/v1/socket, Subprotokoll ais.v1.
• Unbekannte Erweiterungen werden ignoriert, Erweiterungen unter https://fhir.labcomplete.at/ais/v1 nur die, die dieser Leitfaden definiert.

Grenzen

Ein Frame hat höchstens 10 MiB. Ein Dokument kommt darin dreimal base64-kodiert an (in der Nachricht, im JWS, im JWE), jedes Mal ein Drittel größer; darum schickt labcomplete Dokumente bis 4 MiB, damit ein Druck sicher in einen Frame passt.

Einrichtung

Vor dem ersten Verbindungsaufbau tauschen AIS und labcomplete:

Das AIS nennt	labcomplete nennt
seinen Issuer	seinen Issuer (labcomplete-test auf der Testumgebung, labcomplete in Produktion)
die öffentlichen JWK zum Signieren und zum Verschlüsseln	seine öffentlichen JWK zum Signieren und zum Verschlüsseln
seine Namensräume für Ordinationen (Zuweiser), Benutzer und Patienten, je eine URI unter seiner Kontrolle	den Endpunkt und das Subprotokoll
die Web-Origins, aus denen es den Einmal-Link öffnet	die Kurznamen und GDA-OIDs der Labors seiner Ordinationen
ob es die Patientendaten führt und ob es einen zweiten Faktor der Anmeldung bürgt	—
ob Benutzer in einer Sitzung auch frei Anforderungen anlegen dürfen	—

Ein neuer Schlüssel wird angekündigt und gilt eine Zeit lang neben dem alten.