Acne
Body Request
If you need to analyze an image whose known condition is acne, you can send a follow up request to the API.
An example of the body of the request can be the following:
{
"requestId": "76925097-820b-403d-a75d-4cd989903df1",
"data": {
"type": "image",
"modality": "clinical",
"operator": "Practitioner",
"bodySite": "HEAD_FRONT",
"knownConditionForThisImage": {
"conclusion": "Acne"
},
"previousMedia": [
{
"content": "base64 image",
"date": "2022-02-22T12:16:59+01:00"
}
],
"subject": {
"identifier": "6ec724a0-6fa3-11eb-a15f-0242ac160004",
"gender": "m",
"height": 175,
"weight": 71,
"birthdate": "1986-10-21",
"generalPractitioner": {
"identifier": "44f89a8c-6f8a-11eb-9c8a-0242ac160004"
},
"managingOrganization": {
"identifier": "b13cd636-327b-11ec-86b0-0242ac180004",
"display": "Hospital Central"
}
},
"scoringSystems": ["ALEGI", "DLQI"],
"questionnaireResponse": {
"DLQI": {
"question1": 2,
"question2": 3,
"question3": 1,
"question4": 2,
"question5": 1,
"question6": 2,
"question7": 2,
"question8": 2,
"question9": 3,
"question10": 2
}
},
"content": "base64 image"
}
}
This is the description of the relevant properties of the body request:
bodySiteis the body site code identifying the zone where the photo was taken. You can find the available list with all the admitted codes here.knownConditionForThisImageis set to the codeAcne, so the API will run the specific algorithms related to this pathology.previousMediais not mandatory. It is an array with a set of the previous images of the analyzed condition. The AI algorithms use this information to calculate the final report.scoringSystemsis an array with the scoring systems to be calculated. For acne we support:ALEGI, an scoring system defined by Legit.Health to track the acne pathology.DLQI.
questionnaireResponse. See next section 😁
How to fill questionnaireResponse
The property questionnaireResponse must contain all the mandatory answers to each scoring system specified in the property scoringSystems.
For example, if you want the API to compute the DLQI, questionnaireResponse["DLQI"] must contain the ten values corresponding to the ten questions DLQI has.
Questionnaires for scoring systems
In the following snippet you will find the questionnaires related to each scoring system related to Acne. If you want the AI calculate one of them, you must get from that info from the patient or the practitioner.
[
{
"code": "DLQI",
"questions": [
{
"code": "question1",
"label": "Over the last week, how itchy, sore, painful or stinging has your skin been?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question2",
"label": "Over the last week, how embarrassed or self conscious have you been because of your skin?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question3",
"label": "Over the last week, how much has your skin interfered with you going shopping or looking after your home or garden? ",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question4",
"label": "Over the last week, how much has your skin influenced the clothes you wear?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question5",
"label": "Over the last week, how much has your skin affected any social or leisure activities?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question6",
"label": "Over the last week, how much has your skin made it difficult for you to do any sport?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question7",
"label": "Over the last week, how much has your skin prevented you from working or studying?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question8",
"label": "Over the last week, how much has your skin created problems with your partner or any of your close friends or relatives?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question9",
"label": "Over the last week, how much has your skin caused any sexual difficulties?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question10",
"label": "Over the last week, how much of a problem has the treatment for your skin been, for example by making your home messy, or by taking up time?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
}
]
}
]
Response
{
"category": [
{
"coding": [
{
"code": "250171008",
"display": "Clinical history and observation finding",
"system": "http://snomed.info/sct"
}
]
}
],
"code": {
"coding": [
{
"code": "10206-1",
"display": "Physical findings of Skin Narrative",
"system": "http://loinc.org"
}
]
},
"detectedModality": "Clinical",
"device": {
"deviceName": {
"name": "Legit.Health",
"type": "user-friendly-name"
},
"manufacturer": "AI LABS GROUP SL",
"resourceType": "Device",
"type": {
"code": "string",
"display": "Dermatology picture archiving and communication system application software",
"system": "http://snomed.info/sct"
}
},
"evolution": {
"domains": {
"ALEGI": {
"explainabilityMedia": {
"content": "base 64 image",
"detections": [
{
"confidence": 98,
"label": "Acne lesion",
"p1": {
"x": 202,
"y": 101
},
"p2": {
"x": 252,
"y": 154
}
},
{
"confidence": 92,
"label": "Acne lesion",
"p1": {
"x": 130,
"y": 194
},
"p2": {
"x": 179,
"y": 245
}
}
]
},
"facets": {
"lesionDensity": {
"intensity": 0,
"value": 0
},
"lesionNumber": {
"intensity": 0,
"value": 0
}
},
"grade": {
"category": "Grade 1",
"score": 0
}
},
"DLQI": {
"explainabilityMedia": {
"content": null,
"detections": null
},
"facets": {
"question1": {
"intensity": null,
"value": 2
},
"question2": {
"intensity": null,
"value": 2
},
"question3": {
"intensity": null,
"value": 2
},
"question4": {
"intensity": null,
"value": 2
},
"question5": {
"intensity": null,
"value": 2
},
"question6": {
"intensity": null,
"value": 2
},
"question7": {
"intensity": null,
"value": 2
},
"question8": {
"intensity": null,
"value": 2
},
"question9": {
"intensity": null,
"value": 2
},
"question10": {
"intensity": null,
"value": 2
}
},
"grade": {
"category": "Very large effect on patient's life",
"score": 20
}
}
}
},
"explainabilityMedia": {
"content": "base64 image",
"modality": "Clinical",
"resourceType": "Media",
"type": "image"
},
"mediaValidity": {
"isValid": true,
"metrics": {
"hasEnoughQuality": true,
"isDermatologyDomain": true
},
"score": 66.0
},
"metrics": {
"category": "calculation",
"resourceType": "DeviceMetric",
"sensitivity": 99.56,
"specificity": 93.99
},
"preliminaryFindings": {
"hasConditionSuspicion": 99.2,
"isMalignantSuspicion": 0,
"isPreMalignantSuspicion": 0.6000000000000001,
"needsBiopsySuspicion": 0,
"needsSpecialistsAttention": 3.86
},
"resourceType": "DiagnosticReport",
"status": "preliminary",
"time": 1.9728517532348633,
"conclusions": [
{
"code": {
"code": "",
"codeSystem": "ICD-11"
},
"name": "Acne",
"probability": 98.66
},
{
"code": {
"code": "",
"codeSystem": "ICD-11"
},
"name": "Nonspecific lesion",
"probability": 1.34
}
]
}