Saltar al contenido

API del catálogo LEEX

Los mismos datos que publica el sitio, en JSON: los equipos por área y familia, la ficha de cada equipo y los distribuidores oficiales. De solo lectura y sin clave.

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.

Ejemplo
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.

Ejemplo
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.

Ejemplo
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.

Ejemplo
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.

Hablar con un especialistaConsultar

Consulta

¿En qué te ayudamos?

Motivo de la consulta

Te responde el asistente virtual de LEEX y, si hace falta, un asesor. Política de privacidad