Cuestionarios

Cada patología o condición puede estar asociada a uno o varios sistemas de puntuación. Estos sistemas de puntuación pueden calcularse automáticamente a través del análisis de la imagen mediante modelos de IA o pueden requerir respuestas a preguntas específicas del paciente o médico. Los endpoints /severity-assessment/* activan el cálculo de estos sistemas de puntuación.

Este endpoint ayuda a:

Identificar si hay sistemas de puntuación asociados a una determinada patología o condición, y proporcionar detalles sobre los mismos.
Proporcionar información sobre cuestionarios asociados, incluyendo el contenido de las preguntas y las opciones de respuesta disponibles.

Al proporcionar el parámetro de consulta pathology con un código ICD-11 (por ejemplo, EA90 para Psoriasis), los usuarios pueden obtener sistemas de puntuación y cuestionarios relevantes adaptados a la patología o condición.

El código ICD-11 es devuelto por el endpoint /diagnosis-support.

GEThttps://medical-device-params.legit.health/v2.0/questionnaires🔓 No Authentication

pathologystringRequired

El código ICD-11 que representa la patología específica para la cual se necesita el cuestionario. Por ejemplo, EA90 representa Psoriasis.

identifierstring

Identificador único para cada sistema de puntuación. Ayuda a los integradores a comprender los resultados, pero no es obligatorio para las peticiones al endpoint. Por ejemplo, apasiLocal o pure4.

codestring

Identificador corto del sistema de puntuación. Esta clave se utiliza en el cuerpo de la petición al endpoint de evaluación de severidad. Por ejemplo, apasi o pure4.

modestring

Especifica si la evaluación es para uso local o global. Valores: local (para áreas corporales específicas) o global (para todo el cuerpo).

pathstring

URL del endpoint para consultar información de evaluación de severidad. Por ejemplo: /severity-assessment/image-based/local o /severity-assessment/text-based.

titleobject

Título de la herramienta de evaluación en varios idiomas. Contiene códigos de idioma (por ejemplo, en_GB, es_ES) como claves con títulos traducidos como valores.

descriptionobject

Descripción breve de la herramienta en varios idiomas. Contiene códigos de idioma (por ejemplo, en_GB, es_ES) como claves con descripciones traducidas como valores.

questionnairearray

Un array de preguntas incluidas en la herramienta de evaluación. Cada objeto de pregunta contiene claves que definen la pregunta y su tipo de entrada.

codestring

Identificador único para la pregunta.

nameobject

Texto de la pregunta en varios idiomas. Contiene códigos de idioma como claves con texto de pregunta traducido como valores.

descriptionobject

Información adicional sobre la pregunta en varios idiomas.

inputobject

Define el tipo de entrada y las restricciones (por ejemplo, number, select).

typestring

El tipo de entrada (por ejemplo, number, select).

minnumber

El valor mínimo para entrada numérica (si aplica).

maxnumber

El valor máximo para entrada numérica (si aplica).

optionsarray

Un array de opciones posibles para una entrada de selección (por ejemplo, opciones Sí/No).

Example request

import requests

url = "https://medical-device-params.legit.health/v2.0/questionnaires"
params = {
  "pathology": "EA90"  # ICD-11 code for Psoriasis
}

response = requests.get(url, params=params)
data = response.json()

print(data)

Response

[
{
  "identifier": "apasiLocal",
  "code": "apasi",
  "mode": "local",
  "path": "/severity-assessment/image-based/local",
  "title": {
    "en_GB": "Local automatic psoriasis area and severity index",
    "es_ES": "Índice automático de gravedad y área de psoriasis local"
  },
  "description": {
    "en_GB": "Clinical tool for a precise psoriasis severity assessment",
    "es_ES": "Herramienta clínica para determinar la gravedad de la psoriasis"
  },
  "questionnaire": [
    {
      "code": "surface",
      "name": {
        "en_GB": "Affected area",
        "es_ES": "Área afectada"
      },
      "description": {
        "en_GB": "This value corresponds to the percentage of involvement of the specific area of the body you are reporting",
        "es_ES": "Este valor corresponde al porcentaje de afectación de la zona concreta del cuerpo que estás reportando"
      },
      "input": {
        "type": "number",
        "min": 0,
        "max": 100
      }
    }
  ]
}
]