Skip to content
This repository has been archived by the owner on May 3, 2023. It is now read-only.

Nutzung des RAT List Distribution Services

Ilya Smirnov edited this page Jan 21, 2022 · 8 revisions

Nutzung des RAT List Distribution Services

Über den hier genannten Dienst kann eine Liste mit gültigen EU RATs (Rapid Antigen Tests) für eine automatisierte Weiterverarbeitung bezogen werden. Diese Liste soll genutzt werden, um die Anforderungen an die Verwendung von aktuell freigegebenen Test Kits bei der Ausstellung von DCCs zu erfüllen.

#f03c15 Bitte, implementieren Sie in Ihrem System eine regelmäßige, z.B. tägliche Prüfung auf neue Versionen der RAT-Liste. Nur zugelassene Test-Kits sollen verwendet werden, um valide Testergebnisse sowie digitale COVID-Zertifikate zu erstellen.

Zugriff auf den Service

Der Endpunkt für den Service lautet: https://distribution.dcc-rules.de/

Hier ist die OpenAPI Dokumentation zu finden.

Unter dem Pfad https://distribution.dcc-rules.de/valuesets sind alle abrufbaren Valuesets und deren Hashwerte (SHA256 über den kompletten content[Server Response]) zu finden. Die RAT Liste hat die ID covid-19-lab-test-manufacturer-and-name. Zum Abruf der Liste muss der im vorherigen Schritt gelieferte Hashwert an den Endpunkt in folgender Weise übergeben werden: https://distribution.dcc-rules.de/valuesets/[Hash]

Wichtig und zu beachten ist, dass sich bei einer Änderung der RAT Liste (covid-19-lab-test-manufacturer-and-name) auch der Hashwert und somit die URL für den Abruf der aktuellen Daten ändert.

Automatisierter Abruf von Valuesets

Für einen automatisierten Abruf der neuesten Daten muss folgender Workflow umgesetzt werden:

  1. Aufruf von https://distribution.dcc-rules.de/
  2. den aktuellen Hashwert zum gewünschten Valueset aus der Response von Schritt 1 ermitteln
  3. das gewünschte Valueset unter https://distribution.dcc-rules.de/valuesets/[Hash] abrufen

Ein geänderter Hashwert bedeutet, dass sich das jeweilige Valueset geändert hat. Die abgerufenen Daten können sie mittels SHA256 Hash über die in der Server-Antwort enthaltenen Daten überprüfen. Dieser Hashwert muss mit dem vom Server in Schritt 1 gelieferten Wert übereinstimmen.

Beispielaufruf

https://distribution.dcc-rules.de/valuesets/29cec19f2db21541308423da55c3223cdf8fbb7ce4eaa0dde97e17961239b738

Liefert eine Liste mit gültigen RATs in folgender Form:

{
  "valueSetId": "covid-19-lab-test-manufacturer-and-name",
  "valueSetDate": "2021-08-02",
  "valueSetValues": {
    "308": {
      "display": "PCL Inc, PCL COVID19 Ag Rapid FIA",
      "lang": "en",
      "active": true,
      "system": "https://covid-19-diagnostics.jrc.ec.europa.eu/devices",
      "version": "2021-05-11 00:00:00 CEST"
    },
...
  }
}

GitHub Repository zum dgca-businessrule-service

Das GitHub Repository zu diesem Service ist hier zu finden: dgca-businessrule-service.