API Reference – Queries

Marlew Queries API Reference

CakePHP 5 · QueriesController /queries .json .xml
Todos los endpoints de datos devuelven un objeto JSON. Agrega la extensión .json (o .xml) a la URL o envía Accept: application/json en el header.
Los parámetros marcados como [opcional] tienen un valor por omisión indicado.
GET Solo lectura – sin body
{param} Parámetro en la URL (requerido)
[param] Parámetro opcional (puede omitirse o enviar "/")

Catálogos simples

8 endpoints

Endpoints que devuelven listas de entidades sin parámetros.

Método Ruta Parámetros URL Descripción · Respuesta Probar
GET /queries/getApplications
Lista de aplicaciones disponibles
{ [id]: [ nombre_es, nombre_en ] }
↗ JSON
GET /queries/getBrands
Lista de marcas con imagen, color y baseline
{ [id]: { id, title, line1, color, colorCmyk, key, baseline, image:{color,black,…} } }
↗ JSON
GET /queries/getCertifications
Lista de certificaciones (imagen, url)
{ [id]: { id, title:[es,en], image, imageHD, imageUltra, order, url } }
↗ JSON
GET /queries/getEvents
Lista de eventos (imagen, url, orden)
[ { id, url, image:[es,en], month:[es,en], order } ]
↗ JSON
GET /queries/getIcons
Lista de íconos con sus tres resoluciones de imagen
{ [id]: { id, label:[es,en], image, imageHD, imageUltra } }
↗ JSON
GET /queries/getInstallations
Lista de tipos de instalación (imagen bilingüe)
{ [id]: { id, label:[es,en], image:[es,en], imageHD:[es,en], imageUltra:[es,en] } }
↗ JSON
GET /queries/getMarkets
Árbol de mercados (leído desde staticData/arbolmercados.php) Devuelve null si el archivo fuente no existe.
{ … árbol de mercados … } | null
↗ JSON
GET /queries/getProperties
Lista de propiedades de familias (es / en)
{ [id]: [ nombre_es, nombre_en ] }
↗ JSON

Categorías y Subcategorías

3 endpoints

Filtrado opcional por origen (dominio del cliente).

Método Ruta Parámetros URL Descripción · Respuesta Probar
GET /queries/getCategories[/{origin}/]
[origin] string
Dominio del cliente. Si contiene "districables.cl" filtra por visible_en_districables=1; si se omite filtra por visible=1
Categorías que tienen al menos una familia visible
{ [id]: { id, label:[es,en], key:[es,en] } }
↗ JSON
GET /queries/getSubcategories[/{origin}/]
[origin] string
Dominio del cliente (mismo criterio que getCategories)
Subcategorías con su categoría padre (familias visibles)
{ [id]: { id, label:[es,en], prefix:[es,en], categoryId, category:{label:[es,en]} } }
↗ JSON
GET /queries/getAllSubcategories
Todas las subcategorías sin filtro de visibilidad Internamente llama a getSubcategories(null, includeAll=true).
{ [id]: { id, label:[es,en], prefix:[es,en], categoryId, category:{label:[es,en]} } }
↗ JSON

Familias de productos

5 endpoints

Endpoints que devuelven listas o fichas de familias de cables.

Método Ruta Parámetros URL Descripción · Respuesta Probar
GET /queries/getFamily/{idioma}/{clave}/
{idioma} es|en
Idioma de búsqueda
{clave} string
Clave de la familia (ej. serie_bx)
Ficha completa de una familia (jsondata + PDFs + subtítulos) Devuelve null si la familia no existe o no está visible.
{ …jsondata…, pdf_es, pdf_en, subtitle_prefix_es, subtitle_prefix_en } | null
↗ JSON
GET /queries/getFamiliesByBrand/{idioma}/{clave}/
{idioma} es|en
Idioma de búsqueda
{clave} string
Clave de la marca (ej. instrumentar)
Todas las familias visibles de una marca Ordenado por: tipo → dimensiones → orden.
{ [id]: { id, order, key:[es,en], serialNumber, modifier, subtitle:[es,en], subtitle_prefix:[es,en], specialFeatures:[es,en], description:[[es,en]], dimensions, type:[es,en], pdfs:[es,en] } }
↗ JSON
GET /queries/getFamiliesByCategory/{idioma}/{clave}[/{origin}/]
{idioma} es|en
Idioma de búsqueda
{clave} string
Clave de categoría (ej. instrumentacion)
[origin] string
Dominio del cliente (filtra por visible_en_districables si contiene "districables.cl")
Familias visibles de una categoría, con subcategoría y marca Ordenado por: subcategoría.orden → dimensiones → familia.orden.
{ [id]: { id, key:[es,en], serialNumber, order, modifier, brandId, brandName, subcategoryId, subcategoryName:[es,en], subtitle:[es,en], subtitle_prefix:[es,en], specialFeatures:[es,en], description:[[es,en]], type:[es,en], dimensions, pdfs:[es,en] } }
↗ JSON
GET /queries/getFamiliesByMarketBranch/{idioma}/{path}/
{idioma} es|en
Idioma de búsqueda
{path} string
Ruta del mercado (ej. oilgas-refinerias-especificos-instrumentacion)
Familias visibles de una rama del árbol de mercados Ordenado por: tipo → dimensiones → orden.
{ [id]: { id, order, key:[es,en], serialNumber, modifier, brandId, brandName, subtitle:[es,en], subtitle_prefix:[es,en], specialFeatures:[es,en], description:[[es,en]], type:[es,en], dimensions, pdfs:[es,en] } }
↗ JSON
GET /queries/getTables/{idioma}/
{idioma} es|en
Idioma del HTML devuelto
Tablas HTML asociadas a familias visibles El campo html incluye el contenido ya renderizado en el idioma pedido.
{ [id]: { html, familia_id, titulo_es } }
↗ JSON

Marlew API · CakePHP 5 · 2026