{"info":{"contact":{"email":"support@miamo.fi","name":"Miamo Intelligence Oy","url":"https://miamo.fi"},"description":"Public product catalogue API for Rakentaja Outlet, a Finnish online store specialising in lighting and electrical supplies at outlet prices. Additive-only in v1; breaking changes will go to v2. Full human-readable docs at /api/v1/docs.","title":"Rakentaja Outlet \u2014 Product API","version":"1.0.0","x-provider":{"contact":"support@miamo.fi","name":"Miamo Intelligence Oy","tagline":"Powered by Miamo","url":"https://miamo.fi"},"x-shop":{"contact":"info@rakentajaoutlet.fi","model":"dropship","name":"Rakentaja Outlet","url":"https://rakentajaoutlet.fi"}},"openapi":"3.1.0","paths":{"/api/v1/categories":{"get":{"operationId":"listCategories","responses":{"200":{"description":"Category list"}},"summary":"List all product categories with counts"}},"/api/v1/products":{"get":{"operationId":"searchProducts","parameters":[{"description":"Free-text search (name, SKU, EAN, category)","in":"query","name":"q","schema":{"type":"string"}},{"description":"Exact SKU lookup (returns 0-1 results)","in":"query","name":"sku","schema":{"type":"string"}},{"description":"Exact EAN lookup, raw value (returns 0-1 results)","in":"query","name":"ean","schema":{"type":"string"}},{"description":"Exact GTIN lookup, uses validated gtin column primarily (returns 0-1 results)","in":"query","name":"gtin","schema":{"type":"string"}},{"description":"Exact brand filter (e.g. ABB, Ensto, Schneider)","in":"query","name":"brand","schema":{"type":"string"}},{"description":"Incremental sync: only products updated after this ISO-8601 timestamp","in":"query","name":"updated_since","schema":{"format":"date-time","type":"string"}},{"description":"Cursor pagination: return products with id > since_id, ordered by id ASC. Overrides page/sort. Response includes next_since_id.","in":"query","name":"since_id","schema":{"type":"integer"}},{"description":"Filter by category ID","in":"query","name":"category","schema":{"type":"integer"}},{"description":"Only show products currently in stock (default: true)","in":"query","name":"in_stock","schema":{"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":24,"maximum":100,"type":"integer"}}],"responses":{"200":{"description":"Paginated product list"}},"summary":"Search and list products"}},"/api/v1/products/lookup":{"post":{"description":"Provide any combination of gtins/eans/skus/ids lists (max 200 total). Returns matching products + list of identifiers that were not found.","operationId":"bulkLookup","requestBody":{"content":{"application/json":{"schema":{"properties":{"eans":{"items":{"type":"string"},"type":"array"},"gtins":{"items":{"type":"string"},"type":"array"},"ids":{"items":{"type":"integer"},"type":"array"},"skus":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Matches + not_found lists"},"400":{"description":"No lookups provided"},"413":{"description":"Too many lookups (max 200)"}},"summary":"Bulk lookup products by GTIN, EAN, SKU or ID"}},"/api/v1/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"}},"/api/v1/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 availability check"}}},"servers":[{"url":"https://rakentajaoutlet.fi"}]}