Skip to main content

Introduction

The device works in a rather straightforward way: you send images and you receive a DiagnosticReport, as defined in the FHIR standard. The following chart explains the basics:

The pages in this section document two generations of the device interface, version 2.0 and version 2.1, so that you can read the interface you are calling. The version identifier that applies to a given device is the one stated on the label.

graph LR A["Your system<br/>(EMR, EHR...)"] B[The device<br/>Legit.Health]:::green A -->|Send:<br/><b>Images</b> and <b>data</b>|B B -.->|Receive:<br/><b>New data</b>|A classDef green fill:#e5edea,stroke:#04af65,stroke-width:1 linkStyle 0 stroke:#8671ff,color:#8671ff linkStyle 1 stroke:#04af65,color:#04af65

The output varies depending on the data​

As you can see, your system will send images and some data to the device. However, depending on the data you send, the output of the device will be somewhat different. For example, the following request only sends an image to the device.

Body of the request without a condition
"data": {
  "content": "base64 encoded image"
}

However, it is also possible to send a request with the key knownConditionForThisImage, alongside the image, as follows:

Body of the request with a condition
"data": {
  "content": "base64 encoded image",
  "knownConditionForThisImage": {
    "conclusion": "code of condition"
  }
}

Summary​

Depending on whether you add the key knownConditionForThisImage, the output from the device will be different, following this logic:

graph LR A{Is there<br/><code>knownCondition-<br/>ForThisImage</code>?} A -->|No|B[The output contains<br/>only <b>Diagnostic</b> data] A -->|Yes|C[The output contains<br/>also <b>Severity</b> data]

As such, you will need to consult the following two sections of this documentation to understand exactly what the output is: Diagnostic support and Severity measure.

In addition, the device runs a domain validation check on the images you submit and reports the result alongside the clinical output.