Zum Hauptinhalt springen

Einen Diagnosebereicht abrufen

Der wichtigste Aspekt einer API-Integration ist die Bereitstellung eines DiagnosticReport mit den von einer Künstlichen Intelligenz bereitgestellten Informationen.

Wir stellen einen Endpunkt zur Verfügung, um einen bereits im System vorhandenen Diagnosebericht abzurufen. Sie benötigen nur die interne ID des Diagnoseberichts in Legit.Health. Diese Kennung ist in dem JSON enthalten, das wir jedes Mal an Ihren Server senden, wenn ein Diagnosebericht erstellt wird.

Um einen Diagnosebericht zu erhalten, müssen Sie den Endpunkt getDiagnosticReport verwenden.

Ein DiagnosticReport enthält alle Informationen zu einem Bild, das für einen Patienten hochgeladen wurde, und die entsprechenden Ergebnisdaten, die von unseren KI-Algorithmen generiert wurden.

Status: Vorläufig

Bitte beachten Sie, dass der Status des Berichts mit vorläufig gekennzeichnet ist, wie im FHIR-Standard definiert.

JSON-Struktur

Die typische JSON-Struktur, die wir an Ihre Server senden, sieht wie folgt aus:

{
"id": "5194dae6-ab96-11ec-9c18-06ef9b8b6824",
"previousDiagnosticReportId": "9c511e48-fab4-11eb-9382-06ef9b8b6824",
"nextDiagnosticReportId": null,
"patient": {
"id": "054724e4-e4b5-11eb-979a-06ef9b8b6824",
"externalId": "2"
},
"encounters": [
{
"id": "054724e4-ab96-11eb-9c18-06ef9b8b6824",
"externalId": "3"
},
{
"id": "86753241-ab96-11eb-9c18-06ef9b8b6824",
"externalId": null
}
],
"condition": {
"id": 704,
"pathology": {
"name": "Psoriasis",
"code": "Psoriasis"
},
"bodySite": {
"code": "HEAD_FRONT",
"name": "Face and neck"
}
},
"originalMedia": {
"type": "Image",
"modality": "Clinical",
"diqaScore": 74,
"url": "https://legit-app-pre.s3.eu-west-3.amazonaws.com/signedPath"
},
"result": {
"id": "5194dd48-ab96-11ec-aead-06ef9b8b6824",
"metrics": {
"sensitivity": 82.69,
"specificity": 97.46
},
"preliminaryFindings": {
"isMalignantSuspicion": 0,
"hasConditionSuspicion": 100,
"isPreMalignantSuspicion": 0,
"adjustedIsPreMalignantSuspicion": null,
"needsBiopsySuspicion": 0,
"needsSpecialistsAttention": 100
},
"iaSeconds": 2.6534740924835,
"explainabilityMedia": {
"type": "Image",
"url": "https://legit-app-pre.s3.eu-west-3.amazonaws.com/diagnostic-report-medias/2afcd009-3eef-4af1-8665-52e91cd7d4da-5178993a-ab96-11ec-84b5-06ef9b8b6824.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA52A2ZCZF32OWDLDS%2F20220330%2Feu-west-3%2Fs3%2Faws4_request&X-Amz-Date=20220330T094629Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=127b72c450ab94979a467fbba8b250fc11a5e6905c1f568944635c5b6dfa9459"
},
"observations": [
{
"originalMedia": {
"type": "Image",
"modality": "Clinical",
"diqaScore": 86,
"url": "https://legit-dev.s3.eu-west-3.amazonaws.com/diagnostic-report-medias/bbb.png"
},
"explainabilityMedia": {
"url": "https://legit-dev.s3.eu-west-3.amazonaws.com/diagnostic-report-medias/ccc.png"
}
},
{
"originalMedia": {
"type": "Image",
"modality": "Clinical",
"diqaScore": 86,
"url": "https://legit-dev.s3.eu-west-3.amazonaws.com/diagnostic-report-medias/bbb.png"
},
"explainabilityMedia": null
}
],
"conclusions": [
{
"pathology": {
"name": "Psoriasis",
"code": "Psoriasis"
},
"probability": 45.13
},
{
"pathology": {
"name": "Psoriasis inversa",
"code": "Psoriasis inversa"
},
"probability": 4.46
},
{
"pathology": {
"name": "Lichen simplex chronicus",
"code": "Lichen simplex chronicus"
},
"probability": 2.18
},
{
"pathology": {
"name": "Erythema multiforme",
"code": "Erythema multiforme"
},
"probability": 1.3
},
{
"pathology": {
"name": "Angiokeratoma",
"code": "Angiokeratoma"
},
"probability": 1.27
}
],
"scoringSystems": [
{
"scoringSystem": {
"name": "Local automatic psoriasis area and severity index",
"code": "APASI"
},
"score": 0.7,
"scoreCategory": "Moderate",
"scoreCategories": [
{
"code": "None",
"min": 0,
"max": 0,
"severity": 1,
"severityAsString": "low",
"category": "None"
},
{
"code": "Mild",
"min": 0,
"max": 2.8,
"severity": 1,
"severityAsString": "low",
"category": "Mild"
},
{
"code": "Moderate",
"min": 2.8,
"max": 6,
"severity": 2,
"bodySite": "LEG_LEFT",
"severityAsString": "moderate",
"category": "Moderate"
},
{
"code": "Severe",
"min": 6,
"max": 28.8,
"severity": 3,
"bodySite": "LEG_LEFT",
"severityAsString": "high",
"category": "Severe"
}
],
"resultScoringSystemFacets": [
{
"facet": {
"name": "Affected area",
"description": "This value corresponds to the percentage of involvement of the specific area of the body you are reporting"
},
"valueToDisplay": "10% (1)",
"rawValue": 1
},
{
"facet": {
"name": "Redness",
"description": "This value corresponds to the redness intensity of the lesion"
},
"valueToDisplay": "Moderate (3)",
"rawValue": 3
},
{
"facet": {
"name": "Induration",
"description": "This value corresponds to the hardening intensity of the lesion"
},
"valueToDisplay": "Moderate (2)",
"rawValue": 2
},
{
"facet": {
"name": "Desquamation",
"description": "This value corresponds to the shedding intensity of the outermost layer of skin of the affected zone"
},
"valueToDisplay": "Moderate (2)",
"rawValue": 2
}
],
"history": [
{
"date": "2021-07-14T15:09:38+00:00",
"score": 2.4,
"scoreCategory": "Severe"
},
{
"date": "2021-08-05T10:49:13+00:00",
"score": 1.6,
"scoreCategory": "Severe"
},
{
"date": "2021-08-11T14:58:38+00:00",
"score": 10,
"scoreCategory": "Severe"
},
{
"date": "2022-03-24T17:17:22+00:00",
"score": 0.7,
"scoreCategory": "Moderate"
}
],
"reduction": 0.70833333333333
},
{
"scoringSystem": {
"name": "Psoriatic arthritis UnclutteRed screening Evaluation",
"code": "PURE4"
},
"score": 2,
"scoreCategory": "Possible psoriatic arthritis",
"resultScoringSystemFacets": [
{
"facet": {
"name": "Have you ever had a globally swollen and painful finger or toe?",
"description": null
},
"valueToDisplay": "Yes (1)"
},
{
"facet": {
"name": "Have you ever had heel pain as soon as you stand up in the morning?",
"description": null
},
"valueToDisplay": "No (0)"
},
{
"facet": {
"name": "Have you ever had left and right buttock pain, at the same time or not?",
"description": null
},
"valueToDisplay": "Yes (1)"
},
{
"facet": {
"name": "Have you ever had a swollen and painful joint? (hands, feet, knees, or ankles, for example)",
"description": null
},
"valueToDisplay": "No (0)"
}
],
"history": [
{
"date": "2021-08-05T10:49:13+00:00",
"score": 1,
"scoreCategory": "Possible psoriatic arthritis"
},
{
"date": "2021-08-11T14:58:38+00:00",
"score": 1,
"scoreCategory": "Possible psoriatic arthritis"
},
{
"date": "2022-03-24T17:17:22+00:00",
"score": 2,
"scoreCategory": "Possible psoriatic arthritis"
}
],
"reduction": 0
}
]
},
"helpDiagnoseQuestionnaireAnswers": [
{
"question": "Do hives/welts appear with associated itching?",
"answer": "Yes",
"text": "Considera urticaria"
},
{
"question": "Do individual hives or welts disappear within 1-24 hours without leaving any marks?",
"answer": "Yes",
"text": "Consider urticaria"
},
{
"question": "Does the patient present angioedema or swelling of any part of the body (e.g., face, hands, feet...) accompanied by itch/pain that disappears within 72 hours without leaving any marks?",
"answer": "No",
"text": "Rule out angioedema associated with urticaria"
},
{
"question": "The patient has experienced these episodes more or less continuously for a period of:",
"answer": "≥6 weeks",
"text": "Consider chronic Urticaria"
}
],
"isPriority": true,
"isReviewed": false,
"createdAt": "2022-03-24T17:17:22+00:00",
"presentedForm": {
"practitioner": {
"url": "https://app.legit.legit/u/patients/xxx/diagnotic-report/yyy"
},
"patient": {
"url": "https://app.legit.legit/u/diagnostic-report/xxxx"
}
}
}

Kennungen

"id": "5194dae6-ab96-11ec-9c18-06ef9b8b6824",
"previousDiagnosticReportId": "9c511e48-fab4-11eb-9382-06ef9b8b6824",
"nextDiagnosticReportId": null,

Die json-Datei enthält 3 Kennungen:

  • id. Die interne Kennung des Diagnoseberichts in der Legit.Health-Datenbank.

  • previousDiagnosticReportId ist die Kennung des unmittelbar vorhergehenden Diagnoseberichts für diese Pathologie, in chronologischer Reihenfolge. Sollte der aktuelle Diagnosebericht der erste sein, wäre die Kennung null.

  • nextDiagnosticReportId ist die Kennung des unmittelbar nächsten Diagnoseberichts für diese Pathologie, in chronologischer Reihenfolge. Sollte der aktuelle Diagnosebericht der neueste sein, wäre die Kennung null.

Patient

"patient": {
"id": "054724e4-e4b5-11eb-979a-06ef9b8b6824",
"externalId": "2"
},

Folgende Informationen über den Patienten sind im Diagnosebericht enthalten:

  • id. Die interne Kennung des Patienten in der Legit.Health-Datenbank.
  • externalId. Die Kennung des Patienten in Ihrem System.

Sitzungen

"encounters": [
{
"id": "054724e4-ab96-11eb-9c18-06ef9b8b6824",
"externalId": "3"
},
{
"id": "86753241-ab96-11eb-9c18-06ef9b8b6824",
"externalId": null
}
],

Nachfolgend die Informationen über die Sitzungen, die im Diagnosebericht enthalten sind.

Es handelt sich um eine Liste, da ein Diagnosebericht mehrere Sitzungen enthalten kann, z. B. eine, die vom Arzt erstellt wurde, und eine andere, die automatisch vom Algorithmus für Folgeuntersuchungen erstellt wurde. Wenn der Patient in einem solchen Fall ein Bild hochlädt, das beiden Sitzungen zugeordnet ist, wird der erstellte Diagnosebericht mit diesen beiden Sitzungen verknüpft.

Jede Sitzung auf der Liste ist ein Objekt mit den folgenden Eigenschaften:

  • id. Die interne Kennung der Sitzung in der Legit.Health-Datenbank.
  • externalId. Die Kennung der Sitzung in Ihrem System.

Krankheitsbild

"condition": {
"id": 704,
"pathology": {
"name": "Psoriasis",
"code": "Psoriasis"
},
"bodySite": {
"code": "HEAD_FRONT",
"name": "Face and neck"
}
}

Wir beziehen Informationen über das Krankheitsbild im jeweiligen Diagnosebericht mit ein.

Im Zusammenhang mit unserem Produkt steht Krankheitsbild für eine Pathologie eines Patienten an einer Körperstelle.

Das Krankheitsbild weist die folgenden Merkmale auf:

  • id. Die interne Kennung des Krankheitsbildes in der Legit.Health-Datenbank.

  • Pathologie. Die Informationen zur Pathologie, für die der Diagnosebericht erstellt wurde. Sollte der Diagnosebericht noch nicht diagnostiziert worden sein, wäre der Wert null.

  • bodySite. Dieses Feld enthält Informationen über die Körperstelle, von der das Bild aufgenommen wurde.

Original Medium (veraltet)

Dieses Feld erscheint jetzt unter Bemerkungen

"originalMedia": {
"type": "Image",
"modality": "Clinical",
"diqaScore": 74,
"url": "https://legit-app-pre.s3.eu-west-3.amazonaws.com/signedPath"
}

Da ein Diagnosebericht einem Bild entspricht, sind auch die folgenden Daten zu diesem Bild aufgeführt.

  • Modalität. Unsere Algorithmen können zwischen Klinischen und Dermatoskopischen Bildern unterscheiden.

  • diqaScore ist die dermathologische Auswertung, die die Aussagekraft des Bildes aus klinischer Sicht misst.

  • URL. Link zum Bild. Da wir ein leistungsfähiges Sicherheitssystem implementiert haben, um den Zugriff auf die Bilder zu schützen, ist dieser Link nur 5 Minuten lang gültig. Sie müssen ihn deshalb verwenden, bevor er abläuft.

Ergebnis

Dieses Objekt enthält das von unserem Produkt ausgegebene Ergebnis.

ID

Die interne Kennung des Ergebnisses in unserer Datenbank.

Metriken

"metrics": {
"sensitivity": 82.69,
"specificity": 97.46
},

Enthält die Werte für "Sensitivität" und "Spezifität" des Bildes.

preliminaryFindings

"preliminaryFindings": {
"hasConditionSuspicion": 100,
"isMalignantSuspicion": 0,
"isPreMalignantSuspicion": 0,
"adjustedIsPreMalignantSuspicion": null,
"needsBiopsySuspicion": 0,
"needsSpecialistsAttention": 100
},

Enthält vorläufige Informationen über das Bild, die im Allgemeinen für den Ablaufplan nützlich sind. Jedes Feld ist eine Zahl, die eine Wahrscheinlichkeit von 0 bis 100 darstellt.

  • isPreMalignantSuspicion und isMalignantSuspicion enthalten die vom Algorithmus berechneten Werte für Malignität und Prämalignität.

  • adjustedIsPreMalignantSuspicion enthält den vom Arzt geschätzten Wert in dem Fall, dass er beschließt, den vorherigen Wert zu überschreiben.

explainabilityMedia (veraltet)

Dieses Feld erscheint jetzt unter Bemerkungen

"explainabilityMedia": {
"type": "Image",
"url": "https://legit-app-pre.s3.eu-west-3.amazonaws.com/diagnostic-report-medias/2afcd009-3eef-4af1-8665-52e91cd7d4da-5178993a-ab96-11ec-84b5-06ef9b8b6824.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIA52A2ZCZF32OWDLDS%2F20220330%2Feu-west-3%2Fs3%2Faws4_request&X-Amz-Date=20220330T094629Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=127b72c450ab94979a467fbba8b250fc11a5e6905c1f568944635c5b6dfa9459"
}

Dies ist das vom Produkt verarbeitete Bild. Es enthält zusätzliche Informationsebenen, die anzeigen, wo sich die Hautläsionen befinden und welche Oberfläche betroffen ist.

  • URL. Link zum analysierten Bild. Da wir ein Sicherheitssystem implementiert haben, um den Zugriff auf die Bilder zu schützen, ist dieser Link nur 5 Minuten lang gültig. Sie müssen ihn deshalb verwenden, bevor er abläuft.

Konklusionen

"conclusions": [
{
"pathology": {
"name": "Psoriasis",
"code": "Psoriasis"
},
"probability": 45.13
}
]

Konklusionen ist ein Array, das eine Liste mit den verschiedenen Wahrscheinlichkeiten der Pathologien enthält, die das Bild darstellen kann. Die Summe der hier angezeigten Wahrscheinlichkeiten liegt bei 100. Jedes Objekt hat ein Array mit den folgenden Elementen:

  • Pathologie: Objekt mit den Informationen über die erkannte Pathologie.

  • Wahrscheinlichkeit: der geschätzte Wahrscheinlichkeitswert für diese Pathologie.

Bemerkungen

Das Feld Bemerkungen ist ein Array von Medien, die jeweils zwei Felder enthalten: originalMedia und explainabilityMedia.

originalMedia: die Medien, die an den Algorithmus zur Analyse gesendet werden. Es umfasst:

  • Typ: Das Format des Bildes.
  • Modalität: Der Kontext oder die Methode der Bildaufnahme.
  • diqaScore: Die Punktzahl der Bewertung der Bildqualität in der Dermatologie (Dermatology Image Quality Assessment, DIQA).
  • URL: Die direkte S3-URL zum Bild. Es handelt sich um eine zeitlich begrenzte signierte URL. Laden Sie sie innerhalb von 30 Minuten nach der Erstellung herunter, wenn Sie sie später verwenden möchten.

explainabilityMedia: das verarbeitete Bild, das den von der KI analysierten Bereich der Läsion hervorhebt. Wie das Originalbild ist auch dies eine zeitlich begrenzte S3-URL. Denken Sie also daran, es bei Bedarf innerhalb von 30 Minuten herunterzuladen. Die explainabilityMedia enthält entweder null oder die URL eines Bildes, das zeigt, was ihre Algorithmen zur Schweregradeinschätzung "erkannt" haben. Hier finden Sie eine ausführliche Erklärung:

  • Wenn es keine abschließende Diagnose für das analysierte Bild gibt, wird dieses Feld auf null gesetzt.
  • Wenn es eine abschließende Diagnose für das analysierte Bild gibt, das Bild aber einer Gruppe von Pathologien zugeordnet ist, für die der Schweregrad noch nicht gemessen wurde, ist dieses Feld ebenfalls null.
  • Sollte es eine abschließende Diagnose für das analysierte Bild und einen trainierten Algorithmus zur Messung des Schweregrads geben, enthält dieses Feld schließlich die URL zu einem Bild, das die analysierten Symptome zeigt.
"observations": [
{
"originalMedia": {
"type": "Image",
"modality": "Clinical",
"diqaScore": 86,
"url": "https://legit-dev.s3.eu-west-3.amazonaws.com/diagnostic-report-medias/bbb.png"
},
"explainabilityMedia": {
"url": "https://legit-dev.s3.eu-west-3.amazonaws.com/diagnostic-report-medias/ccc.png"
}
},
{
"originalMedia": {
"type": "Image",
"modality": "Clinical",
"diqaScore": 86,
"url": "https://legit-dev.s3.eu-west-3.amazonaws.com/diagnostic-report-medias/bbb.png"
},
"explainabilityMedia": null
}
]

scoringSystems

:::Info Was ist ein Bewertungssystem? Damit ein Arzt eine Pathologie überwachen kann, gibt es für einige Krankheitsbilder eine Reihe von Fragebögen, die als Bewertungssysteme bekannt sind.

Zum Beispiel:

KrankheitsbildBewertungssystem
PsoriasisPASI
Atopische DermatitisSCORAD
Urtikaria (Nesselsucht)UAS
Hidradenitis suppurativaISH4

Weitere Informationen finden Sie unter:

:::

"scoringSystems": [
{
"scoringSystem": {
"name": "Local automatic psoriasis area and severity index",
"code": "APASI"
},
"score": 0.7,
"scoreCategory": "Moderate",
"scoreCategories": [
{
"code": "None",
"min": 0,
"max": 0,
"severity": 1,
"severityAsString": "low",
"category": "None"
},
{
"code": "Mild",
"min": 0,
"max": 2.8,
"severity": 1,
"severityAsString": "low",
"category": "Mild"
},
{
"code": "Moderate",
"min": 2.8,
"max": 6,
"severity": 2,
"bodySite": "LEG_LEFT",
"severityAsString": "moderate",
"category": "Moderate"
},
{
"code": "Severe",
"min": 6,
"max": 28.8,
"severity": 3,
"bodySite": "LEG_LEFT",
"severityAsString": "high",
"category": "Severe"
}
],
"resultScoringSystemFacets": [
{
"facet": {
"name": "Affected area",
"description": "This value corresponds to the percentage of involvement of the specific area of the body you are reporting"
},
"valueToDisplay": "10% (1)",
"rawValue": 1
},
{
"facet": {
"name": "Redness",
"description": "This value corresponds to the redness intensity of the lesion"
},
"valueToDisplay": "Moderate (3)",
"rawValue": 3
},
{
"facet": {
"name": "Induration",
"description": "This value corresponds to the hardening intensity of the lesion"
},
"valueToDisplay": "Moderate (2)",
"rawValue": 2
},
{
"facet": {
"name": "Desquamation",
"description": "This value corresponds to the shedding intensity of the outermost layer of skin of the affected zone"
},
"valueToDisplay": "Moderate (2)",
"rawValue": 2
}
],
"history": [
{
"date": "2021-07-14T15:09:38+00:00",
"score": 2.4,
"scoreCategory": "Severe"
},
{
"date": "2021-08-05T10:49:13+00:00",
"score": 1.6,
"scoreCategory": "Severe"
},
{
"date": "2021-08-11T14:58:38+00:00",
"score": 10,
"scoreCategory": "Severe"
},
{
"date": "2022-03-24T17:17:22+00:00",
"score": 0.7,
"scoreCategory": "Moderate"
}
],
"reduction": 0.70833333333333
}

scoringSystems. Die für das Bild ausgefüllten Fragebögen sind in diesem Array enthalten. Jedes Element in dieser Liste hat die folgenden Eigenschaften.

  • resultScoringSystemFacets enthält die Antworten auf die einzelnen Fragen des Bewertungssystems. Jedes Element in dieser Liste enthält die folgenden Informationen:

    • facet, was mit dem Punktesystem zu tun hat.

    • valueToDisplay, die Antwort auf die Anfrage.

  • score ist die berechnete Punktzahl des Bewertungssystems auf der Grundlage der Antworten.

  • scoreCategory ist der Schweregrad entsprechend der erzielten Punktzahl.

  • history sind die Erfahrungswerte für das Bewertungssystem.

  • reduction gibt an, um wie viel sich der Wert des Bewertungssystems seit dem letzten Bild verringert hat. Dieser Wert liegt zwischen 0 und 1.

  • iaSeconds ist die Zeit, die der Algorithmus für die Analyse des Bildes benötigt.

Fragebogen zur Diagnose

"helpDiagnoseQuestionnaireAnswers": [
{
"question": "Do hives/welts appear with associated itching?",
"answer": "Yes",
"text": "Considera urticaria"
},
{
"question": "Do individual hives or welts disappear within 1-24 hours without leaving any marks?",
"answer": "Yes",
"text": "Consider urticaria"
},
{
"question": "Does the patient present angioedema or swelling of any part of the body (e.g., face, hands, feet...) accompanied by itch/pain that disappears within 72 hours without leaving any marks?",
"answer": "No",
"text": "Rule out angioedema associated with urticaria"
},
{
"question": "The patient has experienced these episodes more or less continuously for a period of:",
"answer": "≥6 weeks",
"text": "Consider chronic Urticaria"
}
],

Bei der Diagnose einiger Pathologien, wie z.B. "Melanom", kann der Arzt einen anerkannten Hilfsfragebogen verwenden, der ihn bei diesem Prozess unterstützt.

Wenn der Fragebogen ausgefüllt wurde, erscheint er in dieser Eigenschaft in einem "Frage-Antwort"-Format.

presentedForm

Diese Eigenschaft enthält zwei direkte Links zum Diagnosebericht innerhalb der Anwendung, einen für Patienten und einen für Ärzte.

Weitere Angaben

"isPriority": true,
"isReviewed": false,
"createdAt": "2022-03-24T17:17:22+00:00"

Das JSON enthält außerdem die folgenden Eigenschaften:

  • isPriority gibt an, ob der Diagnosebericht als vorrangig gekennzeichnet wurde. Dies kann geschehen, wenn ein hoher Verdacht auf Malignität besteht oder der Wert einer Auswertung über einem festgelegten Schwellenwert liegt.

  • isReviewed, wenn der Arzt den Diagnosebericht überprüft hat.

  • createdAt. Das Datum des Diagnoseberichts.