Saltar al contenido principal
Este contenido se refiere a versión del dispositivo: 1.1.0.0

Parámetros de Endpoint

Para simplificar el proceso de integración para los equipos técnicos, hemos desarrollado un conjunto de endpoints auxiliares que agilizan el acceso a datos relevantes. Estos endpoints permiten una recuperación rápida y eficiente de información, facilitando la interacción fluida entre los endpoints diagnostic-support y severity-assessment. Esto minimiza la cantidad de código adicional requerido por los integradores.

Sitios Corporales​

Este endpoint auxiliar proporciona una lista estandarizada de códigos de sitios corporales, que se utilizan para especificar la ubicación de una patología en el cuerpo humano. Estos códigos son esenciales para definir con precisión el área afectada al interactuar con el endpoint diagnostic-support.

URL del Endpoint:

https://medical-device-params.legit.health/v2.0/body-sites

Signos Clínicos​

Este endpoint auxiliar ofrece una lista estandarizada de signos clínicos, incluyendo traducciones multilingües de las claves de signos visuales devueltas por el endpoint severity-measurement.

URL del Endpoint:

https://medical-device-params.legit.health/v2.0/clinical-signs

Cuestionarios​

Cada patología o condición puede estar asociada con uno o más sistemas de puntuación. Estos sistemas de puntuación pueden calcularse automáticamente mediante el análisis de imágenes por modelos de IA o pueden requerir respuestas a preguntas específicas del paciente o médico. El endpoint severity-assessment, detallado en la sección de Especificación de Endpoint, activa el cálculo de estos sistemas de puntuación.

Este endpoint ayuda a:

  • Identificar si algún sistema de puntuación está asociado con una patología o condición en particular, y proporcionar detalles sobre ellos.
  • Proporcionar información sobre los 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.

Ejemplo de Solicitud​

https://medical-device-params.legit.health/v2.0/questionnaires?pathology=EA90

Parámetros Requeridos​

La única clave requerida es pathology. Este es el código ICD-11 que representa la patología específica para la cual se necesita el cuestionario. Por ejemplo, EA90 representa Psoriasis.

El código ICD-11 es devuelto por el endpoint diagnostic-support. Consulte la sección de Especificación de Endpoint para obtener detalles sobre cómo recuperar códigos de patología/condición.

Ejemplo de Respuesta​

La API responde con un objeto JSON que contiene uno o más cuestionarios relevantes para la patología especificada. Estos cuestionarios están diseñados para recopilar información estandarizada que ayuda en la evaluación y monitoreo de la condición.

Claves relevantes en el cuerpo de la respuesta
[
  {
    "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
        }
      }
    ]
  }
]

Cheatsheet​

Use este cheatsheet para entender las claves requeridas para consultar el endpoint severity-assessment:

code​

Este es el identificador corto para el sistema de puntuación. Esto es importante porque esta clave se utiliza en el cuerpo de su solicitud bajo el objeto sistemas de puntuación.

path​

Esta es la URL del endpoint para consultar información de evaluación de gravedad. Esto es importante porque le guía a la URL correcta para solicitudes posteriores.

questionnaire y code​

Estas son una serie de preguntas, cada una con un code único. Esto es importante porque estos códigos representan las respuestas a preguntas específicas y son requeridos en su solicitud.

Consejo

Utilice este cheatsheet como referencia rápida para realizar solicitudes precisas al endpoint severity-assessment.

Detalles de la Respuesta​

Descripciones de Claves​

identifier​

Un identificador único para cada sistema de puntuación. Ayuda a los integradores a entender los resultados, pero no es requerido para las solicitudes de endpoint.

Por ejemplo, "apasiLocal" o "pure4".

code​

El identificador corto para el sistema de puntuación. Esta clave se utiliza en el cuerpo de su solicitud al endpoint severity-assessment.

Por ejemplo, "apasi" o "pure4".

mode​

Especifica si la evaluación es para uso local o global.

  • "local" (para áreas corporales específicas)
  • "global" (para todo el cuerpo).
path​

La URL del endpoint para consultar información de evaluación de gravedad.

Por ejemplo:

  • "/severity-assessment/image-based/local"
  • "/severity-assessment/text-based"
title​

El título de la herramienta de evaluación en múltiples idiomas.

{
  "en_GB": "Local automatic psoriasis area and severity index",
  "es_ES": "Índice automático de gravedad y área de psoriasis local"
}
description​

Una breve descripción de la herramienta en múltiples idiomas.

{
  "en_GB": "Clinical tool for a precise psoriasis severity assessment",
  "es_ES": "Herramienta clínica para determinar la gravedad de la psoriasis"
}
questionnaire​

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

[
  {
    "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
    }
  }
]

Dentro de cada pregunta:

  • code: Un identificador único para la pregunta.
  • name: El texto de la pregunta en múltiples idiomas.
  • description: Información adicional sobre la pregunta.
  • input: Define el tipo de entrada y las restricciones (por ejemplo, "number", "select").
    • type: El tipo de entrada (por ejemplo, "number", "select").
    • min/max: Los valores mínimo y máximo para la entrada numérica (si corresponde).
    • options: Una serie de opciones posibles para una entrada de selección (por ejemplo, opciones de Sí/No).