Antes de empezar
- Sin autenticación. No hace falta usuario, clave ni registro.
- Solo lectura. Acepta GET, HEAD, OPTIONS; cualquier otro método responde con un error.
- Sin precios ni escritura. No publica precios ni datos internos, y no permite crear ni modificar nada.
- Los mismos datos que publica el sitio, en castellano y en
application/json. - Desde cualquier origen. Responde con
Access-Control-Allow-Origin: *: también se puede consultar desde un navegador.
Todas las direcciones empiezan con https://leexmedical.com/catalogo/v1.
Descripción para programas y agentes
La descripción completa, con cada parámetro y la forma de cada respuesta, está en OpenAPI 3.1: /openapi.json. El índice /catalogo/v1 lista los endpoints en JSON, y /llms.txt resume el sitio y la API para agentes de IA.
Endpoints
Listar equipos
GET /catalogo/v1/equiposoperationId listarEquipos
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.
curl -s "https://leexmedical.com/catalogo/v1/equipos?area=cuidados-intensivos&familia=ventilacion"Obtener la ficha de un equipo
GET /catalogo/v1/equipos/{slug}operationId obtenerEquipo
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.
curl -s "https://leexmedical.com/catalogo/v1/equipos/k22-pro"Listar áreas clínicas y familias
GET /catalogo/v1/areasoperationId listarAreas
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.
curl -s "https://leexmedical.com/catalogo/v1/areas"Listar distribuidores oficiales
GET /catalogo/v1/distribuidoresoperationId listarDistribuidores
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.
curl -s "https://leexmedical.com/catalogo/v1/distribuidores"Errores
Un error responde con su código HTTP y un cuerpo JSON según RFC 9457: type, title, status y detail; instance, con la ruta pedida; code, el error como identificador estable para un programa; message, el mismo texto que detail; y hint, qué hacer para resolverlo (pista repite el mismo texto). El type es la dirección de su explicación en esta página.
Si el pedido manda Accept: application/problem+json, la respuesta sale como application/problem+json. En cualquier otro caso (sin Accept, con application/json o desde un navegador), el mismo cuerpo sale como application/json; charset=utf-8.
404 · Recurso no encontrado
La dirección no es la de ningún endpoint, o el slug no es el de ningún equipo publicado. Los slugs válidos son los que devuelve el listado de equipos.
code no_encontradotype https://leexmedical.com/developers#no-encontrado
400 · Parámetro inválido
Un filtro del listado de equipos (area o familia) trae un valor que no existe, va más de una vez o pide una familia que no está en el área elegida. La respuesta dice cuál es el parámetro (parametro) y qué valores acepta (valores_validos). Los parámetros que la API no conoce se ignoran.
code parametro_invalidotype https://leexmedical.com/developers#parametro-invalido
405 · Método no permitido
La API es de solo lectura: un pedido POST, PUT, PATCH o DELETE responde con este error y con la cabecera Allow: GET, HEAD, OPTIONS.
code metodo_no_permitidotype https://leexmedical.com/developers#metodo-no-permitido
Versiones
La versión va en la dirección: /catalogo/v1. 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: en sus respuestas, con las cabeceras Deprecation (RFC 9745) y Sunset (RFC 8594), y en esta página.