{"openapi":"3.1.0","info":{"title":"WaldemarArt AI Product Catalog","description":"Read-only API for searching WaldemarArt premium packaging 3D models, packaging 3D mockups, materials, textures, product images and detailed product records.","version":"1.0.0","x-catalog-version":"20260726-230513","x-last-updated":"2026-07-26T23:05:13+00:00"},"servers":[{"url":"https://www.waldemar-art.com","description":"WaldemarArt Design Studio"}],"paths":{"/ai/search":{"get":{"operationId":"searchProducts","summary":"Search WaldemarArt packaging 3D models","description":"Use this action before answering questions about WaldemarArt product availability, sizes, variants, file formats, compatible software, prices, images or related models. Translate and normalize the user request into English before calling this endpoint.","parameters":[{"name":"query","in":"query","required":true,"description":"English search query, for example: Elopak Classic 1000ml, SIG 750ml, honey jar, plastic handle, carton packaging.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of product cards to return.","schema":{"type":"integer","default":10,"minimum":1,"maximum":50}},{"name":"format","in":"query","required":false,"description":"Optional file format filter, for example FBX, OBJ or C4D.","schema":{"type":"string"}},{"name":"software","in":"query","required":false,"description":"Optional compatible software filter, for example Adobe Dimension, Blender, Cinema 4D, KeyShot or Boxshot.","schema":{"type":"string"}},{"name":"material","in":"query","required":false,"description":"Optional material filter, for example glass, carton, plastic, metal or aluminum.","schema":{"type":"string"}},{"name":"capacity","in":"query","required":false,"description":"Optional capacity/weight filter, for example 750ml, 1000ml, 200g or 1.5L.","schema":{"type":"string"}}],"responses":{"200":{"description":"Product search results from the WaldemarArt catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}}}}},"/ai/index.json":{"get":{"operationId":"getAiIndex","summary":"Get the WaldemarArt AI entry point","description":"Returns the AI entry point with endpoint URLs, catalog version, category hints and usage rules.","responses":{"200":{"description":"AI index and endpoint discovery metadata.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/ai-content/{nid}":{"get":{"operationId":"getProductContent","summary":"Get one detailed product or page record","description":"Use the nid returned in search results or ai_content_url to retrieve complete structured data for one public WaldemarArt product/page.","parameters":[{"name":"nid","in":"path","required":true,"description":"Drupal node ID from a WaldemarArt AI search result.","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Detailed public product/page record.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductRecord"}}}},"404":{"description":"Record not found or not public."}}}}},"components":{"schemas":{"ProductCard":{"type":"object","additionalProperties":true,"properties":{"nid":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"ai_content_url":{"type":"string","format":"uri"},"category":{"type":"string"},"subcategory":{"type":"string"},"packaging_type":{"type":"string"},"material":{"type":"string"},"capacity":{"type":"string"},"formats":{"type":"array","items":{"type":"string"}},"compatible_software":{"type":"array","items":{"type":"string"}},"price":{"type":["number","string","null"]},"currency":{"type":"string"},"primary_image":{"type":"string","format":"uri"},"summary":{"type":"string"},"features":{"type":"array","items":{"type":"string"}},"also_available":{"type":"array","items":{"type":"object","additionalProperties":true}},"can_be_combined":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"SearchResponse":{"type":"object","additionalProperties":true,"properties":{"site":{"type":"string"},"base_url":{"type":"string","format":"uri"},"catalog_version":{"type":"string"},"last_updated":{"type":"string"},"usage_hint":{"type":"string"},"query":{"type":"object","additionalProperties":true},"count":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/ProductCard"}}}},"ProductRecord":{"type":"object","additionalProperties":true,"properties":{"nid":{"type":"integer"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"ai_content_url":{"type":"string","format":"uri"},"category":{"type":"string"},"subcategory":{"type":"string"},"packaging_type":{"type":"string"},"material":{"type":"string"},"capacity":{"type":"string"},"formats":{"type":"array","items":{"type":"string"}},"compatible_software":{"type":"array","items":{"type":"string"}},"price":{"type":["number","string","null"]},"currency":{"type":"string"},"primary_image":{"type":"string","format":"uri"},"summary":{"type":"string"},"features":{"type":"array","items":{"type":"string"}},"also_available":{"type":"array","items":{"type":"object","additionalProperties":true}},"can_be_combined":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}}