{"openapi":"3.1.0","info":{"title":"API del catálogo de LEEX","version":"1.0.0","description":"API pública de solo lectura, sin usuario ni clave, del catálogo de equipos médicos de LEEX (tecnología médica para áreas críticas y quirófano en Latinoamérica). Entrega los mismos datos que publica el sitio: los equipos por área clínica y familia, la ficha de cada equipo con sus especificaciones técnicas y los enlaces a su ficha técnica, manual de usuario y folleto, y los distribuidores oficiales por país. No publica precios: para una cotización, la página de contacto del sitio.\n\nErrores: siguen RFC 9457. Con Accept: application/problem+json, la respuesta sale como application/problem+json; en cualquier otro caso, el mismo cuerpo como application/json. Además de type, title, status, detail e instance, el cuerpo trae code (el error como identificador estable: no_encontrado, parametro_invalido, metodo_no_permitido), message (igual a detail) y hint (cómo seguir; pista repite el mismo texto).\n\nVersiones: v1 es estable. Un cambio incompatible sale como una versión nueva, v2, y v1 sigue funcionando. Antes de retirar una versión se avisa con al menos 6 meses de anticipación, con las cabeceras Deprecation (RFC 9745) y Sunset (RFC 8594) en sus respuestas y en https://leexmedical.com/developers#versiones.","contact":{"name":"LEEX","url":"https://leexmedical.com/contacto"}},"externalDocs":{"description":"Guía para desarrolladores","url":"https://leexmedical.com/developers"},"servers":[{"url":"https://leexmedical.com"}],"paths":{"/catalogo/v1/equipos":{"get":{"operationId":"listarEquipos","summary":"Listar equipos","description":"Lista los equipos médicos de LEEX que publica el sitio, uno por modelo, con su tipo, un resumen, la URL de su ficha y las áreas y familias en que figura. Se puede filtrar por área clínica, por familia de equipos o por las dos.","parameters":[{"name":"area","in":"query","required":false,"description":"El área clínica, por su slug (los valores y sus familias: listarAreas). Sin el parámetro, todas.","schema":{"type":"string","enum":["cuidados-intensivos","quirofano-y-anestesia","emergencias-y-traslado","neonatologia-y-obstetricia","cardiologia-y-diagnostico","diagnostico-por-imagenes-y-pocus"]}},{"name":"familia","in":"query","required":false,"description":"La familia de equipos, por su slug. Sola, busca la familia en todas las áreas; con area, tiene que ser una familia de esa área. Sin el parámetro, todas.","schema":{"type":"string","enum":["monitoreo-de-pacientes","centrales-de-monitoreo","ventilacion","infusion","camas-hospitalarias","desfibrilacion","videolaringoscopia","ecografia","maquinas-de-anestesia","mesas-de-cirugia","lamparas-quirurgicas","ventilacion-de-transporte","monitoreo-de-transporte","camillas-y-carros-de-emergencia","ecografia-portatil","incubadoras","cunas-radiantes","fototerapia","monitoreo-fetal","electrocardiografia","gestion-de-estudios","ecografos-institucionales","ecografos-moviles"]}}],"responses":{"200":{"description":"Los equipos.","content":{"application/json":{"schema":{"type":"object","$ref":"#/components/schemas/ListaEquipos"}}}},"400":{"description":"Un filtro con un valor que no existe (trae los valores válidos).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problema"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"404":{"description":"La ruta no existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problema"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"405":{"description":"La API es de solo lectura: GET, HEAD, OPTIONS.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problema"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/catalogo/v1/equipos/{slug}":{"get":{"operationId":"obtenerEquipo","summary":"Obtener la ficha de un equipo","description":"Devuelve la ficha de un equipo como la publica el sitio: descripción, destacados, especificaciones técnicas confirmadas, usos clínicos, configuración, preguntas frecuentes y los enlaces a su ficha técnica, manual de usuario y folleto en PDF.","parameters":[{"name":"slug","in":"path","required":true,"description":"El slug del equipo (el campo slug de listarEquipos; el último tramo de la URL de su ficha), por ejemplo k22-pro.","schema":{"type":"string","enum":["serie-k-pro","k22-pro","serie-cx","serie-iv","iv100","k1","mfm-cms","v3-pro","v8","v7-smart","s7-smart","v9se","s9se","v8v","v6v","cq8k","s5","s8","cr-31","ax3","nano","ax700","ax500","ax400","we2","wh1","l5","lly04b","s7-smart-tci","v1-pro","skb041-3","skb041-1","et054","b6","b3","bq80","bq70","bl70","f3","sd3","mfm-cns","se300b","se1201-pro","se1515","lx9"]}}],"responses":{"200":{"description":"La ficha del equipo.","content":{"application/json":{"schema":{"type":"object","$ref":"#/components/schemas/Equipo"}}}},"404":{"description":"No hay ningún equipo con ese slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problema"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"405":{"description":"La API es de solo lectura: GET, HEAD, OPTIONS.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problema"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/catalogo/v1/areas":{"get":{"operationId":"listarAreas","summary":"Listar áreas clínicas y familias","description":"Lista las seis áreas clínicas del sitio, cada una con sus familias de equipos y los equipos de cada familia. Sirve para conocer los valores válidos de los filtros area y familia.","responses":{"200":{"description":"Las áreas, sus familias y sus equipos.","content":{"application/json":{"schema":{"type":"object","$ref":"#/components/schemas/ListaAreas"}}}},"404":{"description":"La ruta no existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problema"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"405":{"description":"La API es de solo lectura: GET, HEAD, OPTIONS.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problema"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}},"/catalogo/v1/distribuidores":{"get":{"operationId":"listarDistribuidores","summary":"Listar distribuidores oficiales","description":"Lista los distribuidores oficiales de LEEX por país, con su teléfono y la página de LEEX en ese país. Desde otros países de Latinoamérica, la consulta va a LEEX por la página de contacto.","responses":{"200":{"description":"Los distribuidores oficiales.","content":{"application/json":{"schema":{"type":"object","$ref":"#/components/schemas/ListaDistribuidores"}}}},"404":{"description":"La ruta no existe.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problema"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}},"405":{"description":"La API es de solo lectura: GET, HEAD, OPTIONS.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Problema"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problema"}}}}}}}},"components":{"schemas":{"Referencia":{"type":"object","description":"Un área o una familia, por su slug y su nombre.","additionalProperties":false,"required":["slug","nombre"],"properties":{"slug":{"type":"string","description":"El slug, como en las URLs del sitio."},"nombre":{"type":"string","description":"El nombre que muestra el sitio."}}},"Ubicacion":{"type":"object","description":"Un área y una familia en que el sitio muestra el equipo.","additionalProperties":false,"required":["area","familia"],"properties":{"area":{"type":"string","enum":["cuidados-intensivos","quirofano-y-anestesia","emergencias-y-traslado","neonatologia-y-obstetricia","cardiologia-y-diagnostico","diagnostico-por-imagenes-y-pocus"],"description":"El slug del área."},"familia":{"type":"string","enum":["monitoreo-de-pacientes","centrales-de-monitoreo","ventilacion","infusion","camas-hospitalarias","desfibrilacion","videolaringoscopia","ecografia","maquinas-de-anestesia","mesas-de-cirugia","lamparas-quirurgicas","ventilacion-de-transporte","monitoreo-de-transporte","camillas-y-carros-de-emergencia","ecografia-portatil","incubadoras","cunas-radiantes","fototerapia","monitoreo-fetal","electrocardiografia","gestion-de-estudios","ecografos-institucionales","ecografos-moviles"],"description":"El slug de la familia."}}},"EquipoResumen":{"type":"object","description":"Un equipo, como lo lista el sitio.","additionalProperties":false,"required":["slug","nombre","tipo","resumen","url","api_url","imagen","area","familia","ubicaciones"],"properties":{"slug":{"type":"string","enum":["serie-k-pro","k22-pro","serie-cx","serie-iv","iv100","k1","mfm-cms","v3-pro","v8","v7-smart","s7-smart","v9se","s9se","v8v","v6v","cq8k","s5","s8","cr-31","ax3","nano","ax700","ax500","ax400","we2","wh1","l5","lly04b","s7-smart-tci","v1-pro","skb041-3","skb041-1","et054","b6","b3","bq80","bq70","bl70","f3","sd3","mfm-cns","se300b","se1201-pro","se1515","lx9"],"description":"El identificador del equipo; es el último tramo de la URL de su ficha."},"nombre":{"type":"string","description":"El nombre del equipo, como el título de su ficha."},"tipo":{"type":["string","null"],"description":"Qué tipo de equipo es (por ejemplo «Ventilador de cuidados intensivos»)."},"resumen":{"type":["string","null"],"description":"La bajada de su ficha: qué es, en una o dos frases."},"url":{"type":"string","format":"uri","description":"La ficha del equipo en el sitio (la URL canónica)."},"api_url":{"type":"string","format":"uri","description":"La ficha completa del equipo en esta API."},"imagen":{"type":["string","null"],"format":"uri","description":"La foto principal del equipo (WebP, 960 px de ancho)."},"area":{"$ref":"#/components/schemas/Referencia"},"familia":{"$ref":"#/components/schemas/Referencia"},"ubicaciones":{"type":"array","items":{"$ref":"#/components/schemas/Ubicacion"},"description":"Todas las áreas y familias en que figura, en el orden del sitio."}}},"Equipo":{"type":"object","description":"La ficha de un equipo, como la publica el sitio. Sin precios (el sitio no cotiza: para una cotización, la página de contacto).","additionalProperties":false,"required":["slug","nombre","tipo","resumen","url","api_url","imagen","area","familia","ubicaciones","descripcion","destacados","especificaciones","usos","configuracion","preguntas_frecuentes","documentos"],"properties":{"slug":{"type":"string","enum":["serie-k-pro","k22-pro","serie-cx","serie-iv","iv100","k1","mfm-cms","v3-pro","v8","v7-smart","s7-smart","v9se","s9se","v8v","v6v","cq8k","s5","s8","cr-31","ax3","nano","ax700","ax500","ax400","we2","wh1","l5","lly04b","s7-smart-tci","v1-pro","skb041-3","skb041-1","et054","b6","b3","bq80","bq70","bl70","f3","sd3","mfm-cns","se300b","se1201-pro","se1515","lx9"],"description":"El identificador del equipo; es el último tramo de la URL de su ficha."},"nombre":{"type":"string","description":"El nombre del equipo, como el título de su ficha."},"tipo":{"type":["string","null"],"description":"Qué tipo de equipo es (por ejemplo «Ventilador de cuidados intensivos»)."},"resumen":{"type":["string","null"],"description":"La bajada de su ficha: qué es, en una o dos frases."},"url":{"type":"string","format":"uri","description":"La ficha del equipo en el sitio (la URL canónica)."},"api_url":{"type":"string","format":"uri","description":"La ficha completa del equipo en esta API."},"imagen":{"type":["string","null"],"format":"uri","description":"La foto principal del equipo (WebP, 960 px de ancho)."},"area":{"$ref":"#/components/schemas/Referencia"},"familia":{"$ref":"#/components/schemas/Referencia"},"ubicaciones":{"type":"array","items":{"$ref":"#/components/schemas/Ubicacion"},"description":"Todas las áreas y familias en que figura, en el orden del sitio."},"descripcion":{"type":"array","items":{"type":"string"},"description":"La descripción, en párrafos."},"destacados":{"type":"array","items":{"$ref":"#/components/schemas/Destacado"},"description":"Los destacados de la ficha."},"especificaciones":{"type":"array","items":{"$ref":"#/components/schemas/GrupoEspecificaciones"},"description":"Las especificaciones técnicas confirmadas, por grupo."},"usos":{"type":"array","items":{"$ref":"#/components/schemas/Uso"},"description":"Los usos clínicos."},"configuracion":{"type":["object","null"],"description":"Qué trae de serie y qué se suma como opcional (null si la ficha no lo dice).","additionalProperties":false,"required":["estandar","opcional"],"properties":{"estandar":{"type":"array","items":{"type":"string"},"description":"La configuración estándar."},"opcional":{"type":"array","items":{"type":"string"},"description":"Los opcionales."}}},"preguntas_frecuentes":{"type":"array","items":{"$ref":"#/components/schemas/PreguntaFrecuente"},"description":"Las preguntas frecuentes."},"documentos":{"type":"array","items":{"$ref":"#/components/schemas/Documento"},"description":"La ficha técnica, el manual de usuario y el folleto, los que tenga."}}},"Destacado":{"type":"object","description":"Un destacado de la ficha.","additionalProperties":false,"required":["titulo","texto","dato","dato_etiqueta"],"properties":{"titulo":{"type":"string","description":"El título."},"texto":{"type":"string","description":"El texto."},"dato":{"type":["string","null"],"description":"La cifra destacada, si la tiene."},"dato_etiqueta":{"type":["string","null"],"description":"Qué mide la cifra destacada."}}},"FilaEspecificacion":{"type":"object","description":"Una especificación técnica confirmada. Si el grupo compara modelos, trae un valor por columna.","additionalProperties":false,"required":["nombre","valor","valores"],"properties":{"nombre":{"type":"string","description":"Qué especifica."},"valor":{"type":["string","null"],"description":"El valor, cuando es uno solo."},"valores":{"type":["array","null"],"items":{"type":"string"},"description":"Un valor por columna del grupo, cuando el grupo compara modelos."}}},"GrupoEspecificaciones":{"type":"object","description":"Un grupo de la tabla de especificaciones técnicas de la ficha.","additionalProperties":false,"required":["grupo","columnas","filas"],"properties":{"grupo":{"type":"string","description":"El nombre del grupo."},"columnas":{"type":["array","null"],"items":{"type":"string"},"description":"Los modelos que compara el grupo, si compara."},"filas":{"type":"array","items":{"$ref":"#/components/schemas/FilaEspecificacion"},"description":"Las especificaciones del grupo."}}},"Uso":{"type":"object","description":"Un uso clínico del equipo.","additionalProperties":false,"required":["titulo","texto"],"properties":{"titulo":{"type":"string","description":"El uso."},"texto":{"type":"string","description":"La explicación."}}},"PreguntaFrecuente":{"type":"object","description":"Una pregunta frecuente de la ficha.","additionalProperties":false,"required":["pregunta","respuesta"],"properties":{"pregunta":{"type":"string","description":"La pregunta."},"respuesta":{"type":"string","description":"La respuesta."}}},"Documento":{"type":"object","description":"Un documento oficial del equipo, en PDF.","additionalProperties":false,"required":["tipo","titulo","url","formato","idioma","paginas"],"properties":{"tipo":{"type":"string","enum":["ficha","manual","folleto"],"description":"Ficha técnica, manual de usuario o folleto."},"titulo":{"type":"string","description":"El nombre del documento, como en la ficha."},"url":{"type":"string","format":"uri","description":"El PDF."},"formato":{"type":"string","const":"application/pdf","description":"El formato del archivo."},"idioma":{"type":"string","enum":["es","en"],"description":"El idioma del documento."},"paginas":{"type":"integer","minimum":1,"description":"La cantidad de páginas."}}},"ListaEquipos":{"type":"object","description":"Los equipos que coinciden con los filtros.","additionalProperties":false,"required":["total","filtros","equipos"],"properties":{"total":{"type":"integer","minimum":0,"description":"La cantidad de equipos."},"filtros":{"type":"object","description":"Los filtros aplicados (null: sin filtro).","additionalProperties":false,"required":["area","familia"],"properties":{"area":{"type":["string","null"],"enum":["cuidados-intensivos","quirofano-y-anestesia","emergencias-y-traslado","neonatologia-y-obstetricia","cardiologia-y-diagnostico","diagnostico-por-imagenes-y-pocus",null],"description":"El área."},"familia":{"type":["string","null"],"enum":["monitoreo-de-pacientes","centrales-de-monitoreo","ventilacion","infusion","camas-hospitalarias","desfibrilacion","videolaringoscopia","ecografia","maquinas-de-anestesia","mesas-de-cirugia","lamparas-quirurgicas","ventilacion-de-transporte","monitoreo-de-transporte","camillas-y-carros-de-emergencia","ecografia-portatil","incubadoras","cunas-radiantes","fototerapia","monitoreo-fetal","electrocardiografia","gestion-de-estudios","ecografos-institucionales","ecografos-moviles",null],"description":"La familia."}}},"equipos":{"type":"array","items":{"$ref":"#/components/schemas/EquipoResumen"},"description":"Los equipos, en el orden del sitio."}}},"Familia":{"type":"object","description":"Una familia de equipos de un área.","additionalProperties":false,"required":["slug","nombre","url","api_url","equipos"],"properties":{"slug":{"type":"string","enum":["monitoreo-de-pacientes","centrales-de-monitoreo","ventilacion","infusion","camas-hospitalarias","desfibrilacion","videolaringoscopia","ecografia","maquinas-de-anestesia","mesas-de-cirugia","lamparas-quirurgicas","ventilacion-de-transporte","monitoreo-de-transporte","camillas-y-carros-de-emergencia","ecografia-portatil","incubadoras","cunas-radiantes","fototerapia","monitoreo-fetal","electrocardiografia","gestion-de-estudios","ecografos-institucionales","ecografos-moviles"],"description":"El slug de la familia (el valor del filtro familia)."},"nombre":{"type":"string","description":"El nombre de la familia."},"url":{"type":"string","format":"uri","description":"La página de la familia en el sitio."},"api_url":{"type":"string","format":"uri","description":"Los equipos de la familia en esta API."},"equipos":{"type":"array","items":{"type":"string"},"description":"Los slugs de los equipos que el sitio muestra en la familia."}}},"Area":{"type":"object","description":"Un área clínica.","additionalProperties":false,"required":["slug","nombre","descripcion","url","familias"],"properties":{"slug":{"type":"string","enum":["cuidados-intensivos","quirofano-y-anestesia","emergencias-y-traslado","neonatologia-y-obstetricia","cardiologia-y-diagnostico","diagnostico-por-imagenes-y-pocus"],"description":"El slug del área (el valor del filtro area)."},"nombre":{"type":"string","description":"El nombre del área."},"descripcion":{"type":"string","description":"Qué resuelve LEEX en el área, como lo dice el sitio."},"url":{"type":"string","format":"uri","description":"La página del área en el sitio."},"familias":{"type":"array","items":{"$ref":"#/components/schemas/Familia"},"description":"Sus familias de equipos, en el orden del sitio."}}},"ListaAreas":{"type":"object","description":"Las áreas clínicas del sitio.","additionalProperties":false,"required":["total","areas"],"properties":{"total":{"type":"integer","minimum":0,"description":"La cantidad de áreas."},"areas":{"type":"array","items":{"$ref":"#/components/schemas/Area"},"description":"Las áreas, en el orden del sitio."}}},"Distribuidor":{"type":"object","description":"Un distribuidor oficial de LEEX en un país (representa a LEEX; no es parte de LEEX).","additionalProperties":false,"required":["pais","nombre","telefono","direccion","pagina"],"properties":{"pais":{"type":"string","description":"El país."},"nombre":{"type":"string","description":"El nombre del distribuidor."},"telefono":{"type":["string","null"],"description":"Su teléfono."},"direccion":{"type":["string","null"],"description":"Su dirección, donde el sitio la publica."},"pagina":{"type":["string","null"],"format":"uri","description":"La página de LEEX en ese país."}}},"ListaDistribuidores":{"type":"object","description":"Los distribuidores oficiales de LEEX.","additionalProperties":false,"required":["total","distribuidores"],"properties":{"total":{"type":"integer","minimum":0,"description":"La cantidad de distribuidores."},"distribuidores":{"type":"array","items":{"$ref":"#/components/schemas/Distribuidor"},"description":"Uno por país."}}},"Problema":{"type":"object","description":"Un error (RFC 9457). Sale como application/problem+json si el pedido lo pide en Accept; si no, el mismo cuerpo como application/json. code, message y hint son miembros de extensión.","required":["type","title","status","detail","code","message","hint","pista"],"properties":{"type":{"type":"string","format":"uri","description":"El tipo de error: una URL con su explicación."},"title":{"type":"string","enum":["Recurso no encontrado","Parámetro inválido","Método no permitido"],"description":"El tipo de error, en palabras."},"status":{"type":"integer","enum":[404,400,405],"description":"El código HTTP."},"detail":{"type":"string","description":"Qué pasó con este pedido."},"code":{"type":"string","enum":["no_encontrado","parametro_invalido","metodo_no_permitido"],"description":"El tipo de error como identificador estable, para un programa (no cambia dentro de v1)."},"message":{"type":"string","description":"Lo mismo que detail."},"instance":{"type":"string","description":"La ruta pedida."},"hint":{"type":"string","description":"Cómo seguir."},"pista":{"type":"string","description":"Lo mismo que hint."},"parametro":{"type":"string","description":"El parámetro inválido (solo en 400)."},"valores_validos":{"type":"array","items":{"type":"string"},"description":"Los valores que acepta ese parámetro (solo en 400)."}}}}}}