{"openapi":"3.1.0","info":{"title":"Mobis Outlet — API pública de catálogo","version":"1.0","description":"API exclusivamente de lectura para consultar el catálogo público de Mobis Outlet. Los precios se expresan en soles e incluyen IGV; actualmente existen productos con hasta 70% de descuento. No crea pedidos, no reserva stock y no procesa pagos. Versioning and deprecation policy: https://mobis-outlet.com/developers/versioning. Deprecated versions are announced with the standard Deprecation and Sunset HTTP headers at least 90 days before retirement.","termsOfService":"https://mobis-outlet.com/terminos","contact":{"name":"Mobis Outlet","url":"https://mobis-outlet.com/contacto"},"x-api-version-policy":"La versión mayor forma parte de la URL. Los cambios incompatibles se publican en una nueva versión.","x-deprecation-policy":"Las versiones obsoletas se anuncian con las cabeceras Deprecation y Sunset con al menos 90 días de anticipación."},"externalDocs":{"description":"Documentación y política de versiones de la API","url":"https://mobis-outlet.com/developers/versioning"},"servers":[{"url":"https://mobis-outlet.com/api/v1","description":"Producción — versión estable v1"}],"tags":[{"name":"Catálogo","description":"Búsqueda y detalle de productos activos."}],"paths":{"/catalog":{"get":{"operationId":"searchCatalog","tags":["Catálogo"],"summary":"Buscar y filtrar el catálogo","description":"Devuelve productos activos con precio, descuento, stock, variantes, especificaciones, entrega y envío. Repite `category` para filtrar varias categorías.","parameters":[{"name":"q","in":"query","description":"Texto presente en el nombre o la descripción.","schema":{"type":"string","minLength":2,"maxLength":80},"example":"terraza"},{"name":"category","in":"query","description":"Slug de categoría; el parámetro puede repetirse.","schema":{"type":"array","maxItems":7,"items":{"type":"string","enum":["sillas-multiuso","mesas","sillas-de-exterior","sillas-de-oficina","bancos","sofas-y-sillones","accesorios"]}},"style":"form","explode":true},{"name":"min_price_pen","in":"query","schema":{"type":"number","minimum":0,"maximum":10000}},{"name":"max_price_pen","in":"query","schema":{"type":"number","exclusiveMinimum":0,"maximum":10000}},{"name":"min_discount_percent","in":"query","schema":{"type":"number","minimum":0,"maximum":100}},{"name":"color","in":"query","schema":{"type":"string","minLength":1,"maxLength":30},"example":"negro"},{"name":"in_stock_only","in":"query","schema":{"type":"boolean","default":true}},{"name":"order_by","in":"query","schema":{"type":"string","enum":["price_asc","price_desc","discount_desc"],"default":"price_asc"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":8}}],"responses":{"200":{"description":"Catálogo consultado correctamente.","headers":{"Cache-Control":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogResponse"}}}},"400":{"description":"La solicitud no pudo completarse.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"La solicitud no pudo completarse.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"503":{"description":"La solicitud no pudo completarse.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}},"/products/{slug}":{"get":{"operationId":"getCatalogProduct","tags":["Catálogo"],"summary":"Consultar un producto por su slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"example":"peach"}],"responses":{"200":{"description":"Producto encontrado.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"400":{"description":"La solicitud no pudo completarse.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"La solicitud no pudo completarse.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"La solicitud no pudo completarse.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"503":{"description":"La solicitud no pudo completarse.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}}}}},"components":{"schemas":{"ApiErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}},"CommercialContext":{"type":"object","additionalProperties":false,"required":["max_advertised_discount_percent","prices_include_igv"],"properties":{"max_advertised_discount_percent":{"type":"integer","const":70},"prices_include_igv":{"type":"boolean","const":true}}},"Image":{"type":"object","additionalProperties":false,"required":["url","alt"],"properties":{"url":{"type":"string","format":"uri"},"alt":{"type":["string","null"]}}},"Variant":{"type":"object","additionalProperties":false,"required":["id","sku","color","color_hex","stock","availability","images"],"properties":{"id":{"type":"string"},"sku":{"type":["string","null"]},"color":{"type":"string"},"color_hex":{"type":"string"},"stock":{"type":"integer","minimum":0},"availability":{"type":"string","enum":["in_stock","limited_availability","out_of_stock"]},"images":{"type":"array","items":{"$ref":"#/components/schemas/Image"}}}},"Product":{"type":"object","additionalProperties":false,"required":["id","sku","name","slug","canonical_url","description","category","brand","country_of_origin","price","stock","availability","delivery_time","shipping","specifications","images","variants","updated_at"],"properties":{"id":{"type":"string"},"sku":{"type":["string","null"]},"name":{"type":"string"},"slug":{"type":"string"},"canonical_url":{"type":"string","format":"uri"},"description":{"type":["string","null"]},"category":{"oneOf":[{"type":"object","required":["name","slug"],"properties":{"name":{"type":"string"},"slug":{"type":"string"}}},{"type":"null"}]},"brand":{"type":["string","null"]},"country_of_origin":{"type":["string","null"]},"price":{"type":"object","required":["currency","current","reference","discount_percent"],"properties":{"currency":{"type":"string","const":"PEN"},"current":{"type":"number","minimum":0},"reference":{"type":["number","null"],"minimum":0},"discount_percent":{"type":"number","minimum":0,"maximum":100}}},"stock":{"type":"integer","minimum":0},"availability":{"type":"string","enum":["in_stock","limited_availability","out_of_stock"]},"delivery_time":{"type":["string","null"]},"shipping":{"type":"object","required":["cost","currency","coverage"],"properties":{"cost":{"type":"number","const":0},"currency":{"type":"string","const":"PEN"},"coverage":{"type":"string"}}},"specifications":{"type":"object","required":["dimensions","materials","weight","max_weight_capacity","warranty","assembly_required"],"properties":{"dimensions":{"type":["string","null"]},"materials":{"type":"array","items":{"type":"string"}},"weight":{"type":["string","null"]},"max_weight_capacity":{"type":["string","null"]},"warranty":{"type":["string","null"]},"assembly_required":{"type":["boolean","null"]}}},"images":{"type":"array","items":{"$ref":"#/components/schemas/Image"}},"variants":{"type":"array","items":{"$ref":"#/components/schemas/Variant"}},"updated_at":{"type":"string","format":"date-time"}}},"CatalogStats":{"type":["object","null"],"properties":{"price_min":{"type":"number"},"price_max":{"type":"number"},"max_discount":{"type":"number"},"min_discount":{"type":"number"},"tied_at_top":{"type":"integer"},"total_matches":{"type":"integer"}}},"CatalogResponse":{"type":"object","required":["success","schema_version","data_as_of","commercial_context","query","pagination","stats","products"],"properties":{"success":{"type":"boolean","const":true},"schema_version":{"type":"string","const":"1.0"},"data_as_of":{"type":["string","null"],"format":"date-time"},"commercial_context":{"$ref":"#/components/schemas/CommercialContext"},"query":{"type":"object"},"pagination":{"type":"object","required":["page","limit","total_items","total_pages"],"properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total_items":{"type":"integer"},"total_pages":{"type":"integer"}}},"stats":{"$ref":"#/components/schemas/CatalogStats"},"products":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}},"ProductResponse":{"type":"object","required":["success","schema_version","data_as_of","commercial_context","product"],"properties":{"success":{"type":"boolean","const":true},"schema_version":{"type":"string","const":"1.0"},"data_as_of":{"type":"string","format":"date-time"},"commercial_context":{"$ref":"#/components/schemas/CommercialContext"},"product":{"$ref":"#/components/schemas/Product"}}}}}}