2025.2.0 - ci-build
IGTTPFHIRGatewaygPAS - Local Development build (v2025.2.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
OperationDefinition: dePseudonymize
| Official URL: https://ths-greifswald.de/fhir/OperationDefinition/gpas/dePseudonymize | Version: 2025.2.0 | |||
| Active as of 2025-06-12 | Computable Name: DePseudonymize | |||
Abfrage je eines Originalwertes für eine Liste von 1-n Pseudonymen und eine spezifische Domäne.
Unterstützt ab TTP-FHIR Gateway Version 1.0.0
Suche von Originalwerten
Abfrage je eines Originalwertes für eine Liste von 1-n Pseudonymen und eine spezifische Domäne.
Voraussetzung
Die angegebene Pseudonym-Domäne muss in gPAS konfiguriert und das angegebene Pseudonym in dieser Domäne bereits vorhanden sein.
URL: [base]/$dePseudonymize
Parameters
| Use | Name | Scope | Cardinality | Type | Binding | Documentation |
| IN | target | 1..1 | string (string) | Angabe der Domäne auf Basis derer für das angegebene Pseudonym ein vorhandener eindeutiger Originalwert gesucht wird | ||
| IN | pseudonym | 1..* | string (string) | Angabe einer Liste von 1-n Pseudonymen für die in der angegebenen Domäne zugeordnete eindeutige Originalwerte gesucht werden | ||
| OUT | original | 0..* | Original-Identifikation zum übermittelten Pseudonym | |||
| OUT | original.original | 1..1 | Identifier | Original-Identifikator | ||
| OUT | original.target | 1..1 | Identifier | Target-Identifikator | ||
| OUT | original.pseudonym | 1..1 | Identifier | Patient-Identifier | ||
| OUT | error | 0..* | Fehlerrückgabe bei Teil-Fehlern | |||
| OUT | error.original | 0..1 | Identifier | Original-Identifikator | ||
| OUT | error.target | 0..1 | Identifier | Target-Identifikator | ||
| OUT | error.pseudonym | 0..1 | Identifier | Patient-Identifikator | ||
| OUT | error.error-code | 1..1 | Coding | Fehlercode |
Abfrage je eines Originalwertes für eine Liste von 1-n Pseudonymen und eine spezifische Domäne.
Hinweise
Aufruf und Rückgabe
Die bereitgestellte Funktionalität kann per POST-Request aufgerufen werden. Die erforderlichen Angaben werden per POST-BODY in Form von FHIR Parameters übermittelt.
<HOST>:<PORT>/ttp-fhir/fhir/gpas/$dePseudonymize
Der Funktionsaufruf liefert ein ParameterSet bestehend aus multiplen benannten Parametern zurück:
- target = die genutzte Ziel-Domäne (Teil des Requests)
- pseudonym = das angefragte Pseudonym (Teil des Requests)
- original = der ermittelte Originalwert
Im Erfolgsfall wird der HTTP Statuscode 200 zurückgegeben.
Im Fehlerfall wird einer der folgenden HTTP Statuscodes in Verbindung mit einer OperationOutcome-Ressource zurückgegeben:
- 400: Fehlende oder fehlerhafte Parameter.
- 401: Fehlende Authentifizierung oder Autorisierung.
- 404: Parameter mit unbekanntem Inhalt.
- 422: Fehlende oder falsche Patienten-Attribute.
Auftretende Fehler (z.B. angegebenes Pseudonym ist unbekannt) werden im Einzelnen entsprechend per Coding vom Typ Issue-Type signalisiert.