{"info":{"contact":{"email":"okunkoneosa@okunkoneosa.fi","name":"Okun Koneosa Oy","url":"https://okunkoneosa.fi"},"description":"Public API for searching industrial supplies, tools, protective equipment and machine parts. Over 6500 products available from stock in Outokumpu, Finland. Free shipping on orders over 150 EUR.","title":"Okun Koneosa Oy \u2014 Product API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/categories":{"get":{"operationId":"listCategories","responses":{"200":{"description":"Category list"}},"summary":"List all product categories with product counts"}},"/products":{"get":{"operationId":"searchProducts","parameters":[{"description":"Search keyword (name, ordering number, or EAN)","in":"query","name":"q","schema":{"type":"string"}},{"description":"Filter by category ID","in":"query","name":"category","schema":{"type":"integer"}},{"description":"Only show products in stock","in":"query","name":"in_stock","schema":{"default":true,"type":"boolean"}},{"description":"Sort order","in":"query","name":"sort","schema":{"enum":["name","price_asc","price_desc","newest"],"type":"string"}},{"in":"query","name":"page","schema":{"default":1,"type":"integer"}},{"in":"query","name":"per_page","schema":{"default":50,"maximum":100,"type":"integer"}}],"responses":{"200":{"description":"Product list with pagination"}},"summary":"Search products by keyword, category, or EAN code"}},"/products/{id}":{"get":{"operationId":"getProduct","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Product details"},"404":{"description":"Product not found"}},"summary":"Get full product details including variants and stock level"}},"/products/{id}/availability":{"get":{"operationId":"checkAvailability","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Stock availability"},"404":{"description":"Product not found"}},"summary":"Real-time stock check for a product"}},"/shipping":{"get":{"operationId":"getShippingMethods","responses":{"200":{"description":"Shipping methods with weight-based pricing"}},"summary":"Available shipping methods and rates"}}},"servers":[{"url":"https://okunkoneosa.fi/api/v1"}]}