{"openapi":"3.1.0","info":{"title":"KOKEN B2B catalogue and quote API","version":"1.0.0","description":"Read the KOKEN HNB product catalogue and send a business request for quote. B2B, adult-market enquiries only; prices are provided on request. Only submit a quote request with the buyer's explicit confirmation of the details and the consent declaration.","contact":{"name":"KOKEN International FZ-LLC","email":"sales@koken-inc.cn","url":"https://kokenstick.com"}},"servers":[{"url":"https://kokenstick.com"}],"paths":{"/catalog.json":{"get":{"operationId":"getCatalog","summary":"List all products with descriptions, flavour profiles and quote links","responses":{"200":{"description":"Product catalogue","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/contact":{"post":{"operationId":"requestQuote","summary":"Send a B2B request for quote to the KOKEN sales team (delivered by email)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["fullName","companyName","country","email","message","consent"],"properties":{"fullName":{"type":"string","description":"Full name"},"companyName":{"type":"string","description":"Company name"},"country":{"type":"string","description":"Country / region"},"email":{"type":"string","format":"email","description":"Email address"},"whatsapp":{"type":"string","description":"WhatsApp number"},"businessType":{"type":"string","enum":["Brand owner","Importer","Wholesaler","Retail chain buyer","OEM client","Other business enquiry"],"description":"Business type"},"estimatedVolume":{"type":"string","description":"Estimated bulk volume"},"targetMarket":{"type":"string","description":"Target market"},"message":{"type":"string","description":"Message"},"consent":{"type":"string","const":"accepted","description":"Buyer confirms this is a lawful adult-market B2B enquiry."},"lineItems":{"type":"array","description":"Products to quote. Use slugs from the catalogue.","items":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string","enum":["amber-tobacco-sticks","blue-tobacco-sticks","silver-tobacco-sticks","tobacco-classic-sticks","blueberry-tobacco-sticks","vanilla-tobacco-sticks","menthol-tobacco-sticks","black-tea-herbal-sticks","apple-herbal-sticks","strawberry-herbal-sticks","mango-herbal-sticks","blueberry-herbal-sticks","coffee-herbal-sticks","lime-herbal-sticks","grapeel-herbal-sticks","hnb-device-programme","private-label-packaging"]},"quantity":{"type":"integer","minimum":1,"description":"Quantity or reference amount"}}}}}}}}},"responses":{"200":{"description":"Request sent"},"400":{"description":"Missing required fields; the response lists them in `missing`"},"500":{"description":"Could not send; email the sales team directly"}}}}}}