{"openapi":"3.1.0","info":{"title":"Soporte Publicitario: catálogo","version":"1.0.0","description":"API de solo lectura del catálogo de soportes publicitarios. Sin autenticación. Precios netos en pesos chilenos (CLP), más IVA.","contact":{"name":"Soporte Publicitario","url":"https://soportespublicitarios.cl/contacto/","email":"ventas@soportepublicitario.cl"}},"servers":[{"url":"https://soportespublicitarios.cl"}],"paths":{"/api/v1/buscar":{"get":{"operationId":"buscarProductos","summary":"Busca productos por nombre, código o categoría","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Palabras a buscar, por ejemplo: roller 80x200"},{"name":"limite","in":"query","schema":{"type":"integer","default":20,"maximum":50}}],"responses":{"200":{"description":"Resultados","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"productos":{"type":"array","items":{"type":"object","description":"Producto del catálogo. Precios netos en CLP, más IVA.","properties":{"codigo":{"type":"string"},"nombre":{"type":"string"},"url":{"type":"string"},"markdown":{"type":"string"},"categoria":{"type":"string"},"precio_socio":{"type":["integer","null"],"description":"Precio unitario para el Club de Socios"},"precio_directo":{"type":["integer","null"],"description":"Precio unitario para público general"},"precios_por_volumen":{"type":"array","items":{"type":"object","properties":{"cantidad_minima":{"type":"integer"},"precio_socio_unitario":{"type":"integer"}}}},"disponibilidad":{"type":"string","enum":["en_stock","consultar_stock"]},"descripcion":{"type":["string","null"]},"imagenes":{"type":"array","items":{"type":"string"}},"especificaciones":{"type":"object"}}}}}}}}}}}},"/api/v1/productos/{codigo}":{"get":{"operationId":"verProducto","summary":"Un producto por su código","parameters":[{"name":"codigo","in":"path","required":true,"schema":{"type":"string"},"description":"Código del producto, por ejemplo ROLEST080"}],"responses":{"200":{"description":"Producto","content":{"application/json":{"schema":{"type":"object","description":"Producto del catálogo. Precios netos en CLP, más IVA.","properties":{"codigo":{"type":"string"},"nombre":{"type":"string"},"url":{"type":"string"},"markdown":{"type":"string"},"categoria":{"type":"string"},"precio_socio":{"type":["integer","null"],"description":"Precio unitario para el Club de Socios"},"precio_directo":{"type":["integer","null"],"description":"Precio unitario para público general"},"precios_por_volumen":{"type":"array","items":{"type":"object","properties":{"cantidad_minima":{"type":"integer"},"precio_socio_unitario":{"type":"integer"}}}},"disponibilidad":{"type":"string","enum":["en_stock","consultar_stock"]},"descripcion":{"type":["string","null"]},"imagenes":{"type":"array","items":{"type":"string"}},"especificaciones":{"type":"object"}}}}}},"404":{"description":"No existe"}}}},"/api/v1/categorias":{"get":{"operationId":"listarCategorias","summary":"Árbol de categorías del catálogo","responses":{"200":{"description":"Categorías","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}