{"openapi":"3.1.0","info":{"title":"BML BASIC Briefkasten-Konfigurator AI API","version":"1.0.33","description":"Read-only machine interface. Every customer offer is checked by the same server-side construction resolver as the storefront configurator."},"servers":[{"url":"https:\/\/www.briefkasten-manufaktur.de"}],"paths":{"\/basic-briefkasten-konfigurator\/ai":{"get":{"operationId":"openPreconfiguredMailboxSystem","summary":"Create a validated BASIC configuration from simple URL parameters and redirect to the configurator.","parameters":[{"name":"parties","in":"query","required":true,"schema":{"type":"integer","minimum":1,"maximum":60}},{"name":"mount","in":"query","required":false,"schema":{"type":"string"},"examples":{"surface":{"value":"surface"},"freestanding":{"value":"freestanding"}}},{"name":"color","in":"query","required":false,"schema":{"type":"string"},"examples":{"ral7016":{"value":"7016"}}},{"name":"columns","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"rows","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"orientation","in":"query","required":false,"schema":{"type":"string","enum":["vertical","horizontal"]}},{"name":"boxWidthMm","in":"query","required":false,"schema":{"type":"number"},"description":"Explicit BASIC mailbox width. Overrides the 370-mm parcel preference."},{"name":"boxHeightMm","in":"query","required":false,"schema":{"type":"number"}},{"name":"depthMm","in":"query","required":false,"schema":{"type":"number"}},{"name":"bellCount","in":"query","required":false,"schema":{"oneOf":[{"type":"integer","minimum":0,"maximum":60},{"type":"string","enum":["all"]}]},"description":"Number of bells. AI configurations always use BML-9830-KLBMLV (Edelstahl Klingeltaster BASIC + Kunststoff-Namensschild BASIC Typ 2)."},{"name":"camera","in":"query","required":false,"schema":{"type":"string"},"description":"Exact camera\/video-intercom preparation, e.g. DoorBird D2100E."},{"name":"intercom","in":"query","required":false,"schema":{"type":"string"},"description":"Exact separate intercom preparation, e.g. Gira 125800."},{"name":"secondNameplate","in":"query","required":false,"schema":{"oneOf":[{"type":"integer","minimum":0},{"type":"string","enum":["all"]}]}},{"name":"secondNameplatePositions","in":"query","required":false,"schema":{"type":"string"},"description":"Comma-separated 1-based mailbox positions, e.g. 4,6."},{"name":"parcelBoxes","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":20},"description":"Parcel boxes are always placed at the bottom and use BMLZB-SLO-887-7 (large BASIC parcel lock with T-handle)."},{"name":"parcelBoxHeightMm","in":"query","required":false,"schema":{"type":"integer","enum":[110,220,330,440,550]},"description":"Horizontal only; default 330 mm."},{"name":"newspaperBoxes","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":20},"description":"Accessory-box newspaper compartments with fixed BMLZB-SLO-887-10-WBOEM thumb-turn lock."},{"name":"newspaperBoxHeightMm","in":"query","required":false,"schema":{"type":"integer","enum":[110,220]},"description":"Horizontal newspaper compartment height; maximum 220 mm, default 220 mm."},{"name":"functionPosition","in":"query","required":false,"schema":{"type":"string","enum":["auto","left","right","top_left","top_right"]},"description":"Preferred upper side for function boxes; auto defaults to top-right."},{"name":"source","in":"query","required":false,"schema":{"type":"string"},"description":"Tracking source, e.g. biloba. source=biloba is converted to fixed UTM parameters."}],"responses":{"302":{"description":"Redirect to the validated configurator state; invalid inputs fall back to the normal configurator."}}}},"\/bml-form-configurator\/v1-0-33\/ai\/capabilities":{"get":{"operationId":"getConfiguratorCapabilities","summary":"Get allowed mounts, colours, dimensions, layouts and feature IDs.","responses":{"200":{"description":"Capabilities"}}}},"\/bml-form-configurator\/v1-0-33\/ai\/recommend":{"post":{"operationId":"recommendMailboxSystem","summary":"Create up to three validated standard mailbox-system offers from customer requirements.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/RecommendationRequest"}}}},"responses":{"200":{"description":"Validated offers with price, bill of materials and shareUrl"},"422":{"description":"Requirements cannot be fulfilled"}}}},"\/bml-form-configurator\/v1-0-33\/ai\/validate":{"post":{"operationId":"validateConfiguratorState","summary":"Validate a full configurator state and return a directly openable share URL.","requestBody":{"required":true,"content":{"application\/json":{"schema":{"type":"object","required":["state"],"properties":{"state":{"type":"object","additionalProperties":true}}}}}},"responses":{"200":{"description":"Valid, priced configurator state"},"422":{"description":"Invalid or incomplete state"}}}}},"components":{"schemas":{"RecommendationRequest":{"type":"object","required":["mailboxCount"],"properties":{"mailboxCount":{"type":"integer","minimum":1,"maximum":60},"mount":{"type":"string","enum":["Aufputz","Unterputz","Freistehend"]},"orientation":{"type":"string","enum":["vertical","horizontal"]},"columns":{"type":"integer","minimum":1,"description":"Final system grid. Omit unless explicitly requested."},"rows":{"type":"integer","minimum":1,"description":"Final system grid. Omit unless explicitly requested."},"layout":{"type":"string","examples":["3x2"]},"color":{"type":"string","examples":["RAL 7016","Edelstahl"]},"colorId":{"type":"string","examples":["ral_7016","VA"]},"specialColor":{"type":"string"},"boxWidthMm":{"type":"number"},"boxHeightMm":{"type":"number"},"depthMm":{"type":"number"},"bellCount":{"oneOf":[{"type":"integer","minimum":0,"maximum":60},{"type":"string","enum":["all"]}],"description":"Fixed BASIC bell\/nameplate combination BML-9830-KLBMLV."},"camera":{"type":"string","description":"Manufacturer\/model for mechanical preparation only; camera\/electronics are not included."},"intercom":{"type":"string","description":"Manufacturer\/model for mechanical preparation only; speaker\/electronics are not included."},"secondNameplate":{"oneOf":[{"type":"integer","minimum":0},{"type":"string","enum":["all"]}]},"secondNameplatePositions":{"type":"string","description":"Comma-separated 1-based mailbox positions, e.g. 4,6."},"parcelBoxes":{"type":"integer","minimum":0,"maximum":20,"description":"Always bottom, fixed large T-handle parcel lock BMLZB-SLO-887-7."},"parcelBoxHeightMm":{"type":"integer","enum":[110,220,330,440,550]},"newspaperBoxes":{"type":"integer","minimum":0,"maximum":20,"description":"Accessory boxes with fixed BMLZB-SLO-887-10-WBOEM thumb-turn lock."},"newspaperBoxHeightMm":{"type":"integer","enum":[110,220]},"functionPosition":{"type":"string","enum":["auto","left","right","top_left","top_right"]},"standFinish":{"type":"string","enum":["matching","va"]},"standId":{"type":"string"},"backPanel":{"type":"boolean"},"maxCandidates":{"type":"integer","minimum":1,"maximum":3}}}}}}