Die Testergebnisse müssen via POST an den API-Endpoint der entsprechenden Installation gesendet werden:
# Staging
<https://api.staging.domain.de/v1/lab/result>
# Production
<https://api.domain.de/v1/lab/result>
Die o. g. Domain “domain.de” dient nur zur Veranschaulichung der Endpoints. Zur Authentifizierung an den o. g. Endpoints wird ein Bearer-Token benötigt.
Dem Partner werden unterschiedliche Daten (API-Endpoints und Bearer-Token) für „Staging“ und „Production“ zur Verfügung gestellt.
Zum Übermitteln des Ergebnisses für 1 Test ist die folgende Struktur zu verwenden:
{
"id": "A28C97",
"device_type": "NAME DES VERWENDETEN LABORGERÄTS",
"data": {
"result": "negative", // positive, negative, failed
"value": "3000,00",
"test_timestamp": "2021-08-15T15:52:01+00:00"
}
}
Falls mehrere Testergebnisse übermittelt werden sollen, ist die folgende Struktur zu verwenden:
{
"data": [
{
"id": "A28C97",
"device_type": "NAME DES VERWENDETEN LABORGERÄTS",
"data": {
"result": "negative",
"value": "3000,00",
"test_timestamp": "2021-08-15T15:52:01+00:00"
}
},
{
"id": "B27J56",
"device_type": "NAME DES VERWENDETEN LABORGERÄTS",
"data": {
"result": "negative",
"value": "3000,00",
"test_timestamp": "2021-08-15T15:59:01+00:00"
}
}
]
}
Soll ein bereits bestehendes Testergebnis aktualisiert oder korrigiert werden, so muss für “test_timestamp” ein neuer Wert im Datendatensatz gesetzt werden, anderenfalls wird der bestehende Datensatz nicht aktualisiert.