{"openapi":"3.1.0","info":{"title":"Urban Floors vloerkeuzehulp","version":"1.0.0","description":"Machine-readable keuzehulp. Gebruik GET met queryparameters (makkelijkst voor agents). POST is optioneel. Geeft JSON van passende PVC-productpagina's terug."},"servers":[{"url":"https://urbanfloors.nl","description":"Shop-domein (voorkeur voor agents)"},{"url":"https://tracker.urbanfloors.nl","description":"Tracker API"}],"paths":{"/collections/pvc":{"get":{"operationId":"keuzehulpShopGet","summary":"Match via GET op urbanfloors.nl","parameters":[{"name":"view","in":"query","required":true,"schema":{"type":"string","enum":["ai-keuzehulp"]}},{"name":"patroon","in":"query","schema":{"type":"string","enum":["visgraat","rechte-plank","hongaarse-punt","walvisgraat-xl","tegellook","weense-punt"]},"example":"visgraat"},{"name":"kleur","in":"query","schema":{"type":"string","enum":["licht-eiken","naturel-warm-eiken","donker-eiken","eiken","grijs"]},"example":"licht-eiken"},{"name":"woonsituatie","in":"query","schema":{"type":"string"},"example":"vloerverwarming-aanwezig"},{"name":"prijsklasse","in":"query","schema":{"type":"string","enum":["tot-40-euro","40-tot-60-euro","boven-60-euro"]},"example":"tot-40-euro"}],"responses":{"200":{"description":"JSON: schema of productmatches","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/ai/keuzehulp":{"get":{"operationId":"keuzehulpGet","summary":"Schema of match via queryparameters","description":"Zonder parameters: schema van de modal. Met patroon/kleur/woonsituatie: matching producten.","parameters":[{"name":"patroon","in":"query","schema":{"type":"string","enum":["visgraat","rechte-plank","hongaarse-punt","walvisgraat-xl","tegellook","weense-punt"]},"example":"visgraat"},{"name":"kleur","in":"query","schema":{"type":"string","enum":["licht-eiken","naturel-warm-eiken","donker-eiken","eiken","grijs"]},"example":"licht-eiken"},{"name":"woonsituatie","in":"query","description":"Komma-gescheiden ids","schema":{"type":"string"},"example":"vloerverwarming-aanwezig"},{"name":"prijsklasse","in":"query","schema":{"type":"string","enum":["tot-40-euro","40-tot-60-euro","boven-60-euro"]},"example":"tot-40-euro"}],"responses":{"200":{"description":"Schema of match-resultaat","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"operationId":"keuzehulpPost","summary":"Match via JSON-body (optioneel)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"patroon":{"type":"string","enum":["visgraat","rechte-plank","hongaarse-punt","walvisgraat-xl","tegellook","weense-punt"]},"kleur":{"type":"string","enum":["licht-eiken","naturel-warm-eiken","donker-eiken","eiken","grijs"]},"woonsituatie":{"type":"array","items":{"type":"string","enum":["vloerverwarming-aanwezig","appartement-10db-geluidsnorm","intensief-gebruik-kinderen-huisdieren","natte-ruimtes-badkamer"]}},"prijsklasse":{"type":"string","enum":["tot-40-euro","40-tot-60-euro","boven-60-euro"]}}},"example":{"patroon":"visgraat","kleur":"licht-eiken","woonsituatie":["vloerverwarming-aanwezig"]}}}},"responses":{"200":{"description":"Match-resultaat","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"slogan":{"type":"string","example":"de vooruit strevende"},"count":{"type":"integer"},"campaign":{"type":"object","nullable":true,"description":"Lopende cart-actie voor PVC en traprenovatie"},"ai_summary":{"type":"string"},"available_options":{"type":"object","description":"Nog beschikbare filters om de lijst te verkleinen"},"products":{"type":"array","items":{"type":"object","properties":{"handle":{"type":"string"},"title":{"type":"string"},"vendor":{"type":"string"},"currency":{"type":"string","enum":["EUR"]},"price_per_m2":{"type":"number","nullable":true},"price_per_pack":{"type":"number","nullable":true},"m2_per_pack":{"type":"number","nullable":true},"in_stock":{"type":"boolean"},"delivery_lead_time":{"type":"string"},"compare_at_price_per_m2":{"type":"number","nullable":true},"compare_at_price_per_pack":{"type":"number","nullable":true},"rating":{"type":"number","nullable":true},"review_count":{"type":"integer","nullable":true},"url":{"type":"string","format":"uri"},"product_json_url":{"type":"string","format":"uri","description":"Shopify product.js van de productpagina"},"image":{"type":"string","format":"uri","nullable":true},"snippet":{"type":"string"},"tags":{"type":"array","items":{"type":"string"},"description":"Alleen klantgerichte USPs"}}}},"orientation_url":{"type":"string","format":"uri"}}}}}}}}}}}